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About This Manual 


Who should use this manual... 


This guide is intended for the System/36 work station operator who will be using 
the Multiple Session Remote Job Entry (MSRJE) feature and for the System/36 
programmer responsible for configuring System/36 for MSRJE. 

This guide should also be useful to the programmer who is responsible for adding 
System/36 into the host system network as a remote job entry (RJE) work station. 

Using this guide, the operator can: 

• Sign on a display station to MSRJE as a reader 

• Sign on a display station to MSRJE as the MSRJE console 

• Enter MSRJE utility control statements to control an MSRJE session 

• End an MSRJE session 

• Use the MSRJE disk file utility to print data that was written to disk, or to 
convert punch data from a compressed file to a data file 

Using this guide, the System/36 programmer can: 

• Configure System/36 to use MSRJE 

• Write the MSRJE utility control statements to control an MSRJE session 

• Generate forms control table entries to control the destination of output 
received from the host system 

Using this guide, the host system programmer can: 

• If needed, modify host system programs that support RJE to support 
System/36 MSRJE 

• Generate the host system communications network to include System/36 as an 
RJE work station 
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How this manual is arranged 


Chapter 1 introduces the concept of remote job entry and provides an overview of 
the support provided by MSRJE. 

Chapter 2 describes how the MSRJE environment is defined. 

Chapter 3 provides the information necessary to run MSRJE, and describes how 
input to MSRJE and output from MSRJE are handled. 

Chapter 4 describes the MSRJE utility control statements that are used to control 
an MSRJE session. 

Chapter 5 describes the use of the MSRJE forms control table utility. 

Chapter 6 describes the MSRJE disk file utility. 

Chapter 7 discusses the aspects of the BSC host system generation applicable to 
System/36. 

Chapter 8 discusses the aspects of the SNA host system generation applicable to 
System/36. 

Appendix A contains work sheets that can be used to obtain information from or 
give information to the persons responsible for defining System/36 to a host 
system. 

Appendix B defines the format of the SNA bind command that System/3 6 must 
receive before SNA MSRJE can be run. 

Appendix C provides an example of an MSRJE session, including the configuration, 
utility control statements and host system JCL. 

Appendix D shows the default values provided by IBM for use in forms control 
tables. 

Appendix E provides an example of the work sheets that should be filled out to tell 
the operator how to establish the data link on a switched line. 

Appendix F contains a problem determination procedure that can help you find the 
cause of an MSRJE problem. 

The Glossary defines the data processing, data communications, and System/36 
terms used in this manual. 
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What you should know 


The reader is assumed to have read the following manual or have the equivalent 
knowledge: 

• IBM Systeml36 Learning About Your Computer, SC21-9018 

• Using System/36 Communications, SC21-9082 

The System/36 work station operator is expected to be familiar with the operation 
of a System/36 Work Station, and the System/36 programmer is expected to be 
familiar with configuring System/36 for communications. 


If you want more information ... 


System/36 Publications 


I For a list of the available IBM publications, see: 

I • Guide to Publications, GC21-9015, for the 5360 or 5362 System Unit 

1 • Guide to Optional Information, GX21-9817, for the 5364 System Unit (also 

1 known as the System/36 PC) 

I Note: For the 5364, problem determination information is in the manual Operating 

I Your Computer, Therefore, references in this guide to System Problem 

I Determination should be read as references to Operating Your Computer, 
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1 General Information and Architecture 

I You might be interested in the following publications, or equivalent information, 

I about IBM data communications products. 

General Communications 

• Data Communications Concepts, GC21-5169 

Data Link Control 

• IBM Synchronous Data Link Control General Information, GA27-3093 

• General Information—Binary Synchronous Communications, GA27-3004 
Systems Network Architecture (SNA) 

• Systems Network Architecture Reference Summary, GA27-3136 

• Systems Network Architecture Introduction, GA27-3116 

I • Systems Network Architecture: Technical Overview, GC'iO-'^Ol3 

• Systems Network Architecture Format and Protocol Reference Manual: 
Architectural Logic, SC30-3112 

• Systems Network Architecture-Sessions Between Logical Units, GC20-1868 

Communications Controllers 

• IBM 3704 and 3705 Program Reference Handbook, GY30-3012 

• Guide to Using the IBM 3 704 Communications Controller Control Panel, 
GA27-3086 

• Guide to Using the IBM 3705 Communications Controller Control Panel, 
GA27-3087 

• IBM 3704 and 3705 Control Program Generation and Utilities Guide and 
Reference Manual, GC30-3008 

• Introduction to the IBM 3704 and 3705 Communications Controllers, 
GA27-3051 

• 3725 Model 1 Communication Controller, Introduction, GA33-0010 

• 3725 Model 2 Communication Controller, Introduction, GA33-0021 

• 3725 Communication Controller, Principles of Operation, GA33-0013 
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VTAM 

• Advanced Communications Function for VTAM (ACF/VTAM) General 
Information: Introduction, GC27-0462 

• Advanced Communications Function for VTAM (ACF/VTAM) General 
Information: Concepts, GC27-0463 

• Advanced Communications Function for VTAM (ACF/VTAM) System 
Programmer's Guide, SC38-0258 

Job Entry Subsystems (JES) 

OS/VS2 JES2 

• OS/VS2 MVS System Programming Library: JES2 Installation, Initialization 
and Tuning, SC23-0046 

• 0S/VS2 MVS/System Product Version 1 General Information Manual, 
GC28-1025 

• Operator's Library 0S/VS2 Remote Terminals (JES2), GC38-0225 

• Operator's Library: JES2 Commands, SC23-0048 

• OS/VS2 MVS System Programming Library: JES2, GC23-0002 

OS/VS2 JES3 

• Introduction to JES3, GC28-0607 

• 0S/VS2 MVS System Programming Library: JESS, GC28-0608 

• 0S/VS2 MVS System Programming Library: JESS Debugging Guide, 
GC28-0703 

• Operator's Library: OS/VS2 MVS JESS Commands, GC23-0008 

• Operator's Library: 0S/VS2 Remote Terminals (JESS), GC38-0228 

• 0S/VS2 MVS System Programming Library: JESS, GC28-0608 

OS/VSl RES 

• OS/VSl RES System Programmers Guide, GC28-6878 

• OS/VSl RES Workstation User's Guide, GC28-6879 

• OS/VSl Information Distribution Workstation Support General Information, 
GC24-5193 
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VM/370 RSCS 

• Virtual Machine Facility/3 70: Remote Spooling Communications Subsystem 
(RSCS) User’s Guide, GC20-1801 

• IBM Virtual Machine Facility/370: Introduction, GC20-1800 

• IBM Virtual Machine Facility/370: System Programmer’s Guide, GC20-1807 

• IBM Virtual Machine Facility/3 70: Remote Spooling Communications 
Subsystem (RSCS) User’s Guide, GC20-1816 

VSE/POWER with RJE Feature Operating Under DOS/VSE 

. VSE/PO WER General Information Manual, GH12-5128 

• VSE/POWER Installation and Operations Guide, SH12-5329 

. VSE/POWER Specifications, GH12-5046 

. VSE/POWER RJE Users Guide, SH12-5328 

How this manual has changed ... 

The following are major changes made to this manual since the previous edition: 

• MSRJE can be run from the job queue or can be evoked. 

• MSRJE ignores forms control buffer images from host subsystems. 

• MSRJE now supports remote files. 

— Reader can end remote files. 

— Print and punch can read remote forms control tables and create files on a 
remote system. 

• MSRJE can send printer data to disk files that you define. 

• MSRJE can support a host printer balancing function. 
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Chapter 1. Introducing Multiple Session Remote Job Entry 


The System/36 Multiple Session Remote Job Entry (MSRJE) feature allows you to 
submit jobs from System/36 to a host system for processing and to obtain the 
output of those jobs from the host system. MSRJE allows you to use the 
processing power of a host system, and yet maintain your own local applications on 
System/36. To use MSRJE, System/36 must be attached to the host system using 
a data link. With MSRJE, System/36 can communicate with either BSC (binary 
synchronous communications) or SNA (systems network architecture) host 
systems. 


What Is Remote Job Entry? 

Host system sites generally consist of a large computer (such as an IBM 
System/370, IBM 303x System, or an IBM 43xx Processor) with several input and 
output devices. Usually, the input devices are display stations, card readers, disk 
units, tape units, and the system console. The output devices are display stations, 
card punches, disk units, tape units, the system console and printers. Data to be 
processed by the computer is entered through one of the input devices, the 
computer processes the data, and the results of the processing are directed to one 
or more of the output devices. 

Traditionally, computer input has been in the form of punched cards. These cards 
are punched on a keypunch machine by an operator who uses source documents, 
such as orders or invoices, as input. The punched cards are then read into the 
computer by a card reader. Once the computer completes the processing of the 
data, it generates output in the form of printed reports or punched cards. The 
punched c*:.rds generated as output are then either manually stored in a card file or 
used as input to another computer job. 

As companies with this type of installation grew, much of the input to the system 
came from remote locations, such as branch offices or regional warehouses. These 
remote locations generally mailed their source documents to the central site, where 
it was transferred to cards by a keypunch machine operator. The punched cards 
were then read into the computer from a card reader; the computer processed the 
data and generated output in the form of printed reports and punched cards. Any 
of the output required by the remote location was then mailed to the location. As 
information needs grew, it became increasingly obvious that a more timely method 
of submitting data to the computer and receiving output at the remote locations 
was required. The concept of remote job entry grew out of this need for more rapid 
turnaround of jobs processed by the computer. 
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Remote job entry uses a card reader, card punch, and printer at the remote 
locations. These devices are attached to a control unit, which is attached to the 
central site computer through a data link. A keypunch machine is also placed at the 
remote site so that source documents can be transferred to punched cards at the 
remote site. Once the data link is established, the user can enter the host system 
commands and data from the card reader and receive the output from the host 
system at the printer or card punch. The remote location control unit and its 
attached devices are referred to as a remote job entry (RJE) work station. 

Figure 1-1 illustrates the relationships between the central site computer, its local 
devices, and the RJE work station. 


Host Input Devices Host Output Devices 
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Figure 1-1. Overview of RJE Relationship to the Host System 
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Any job that can be entered directly into the host system from its local input 
devices can also be entered from an RJE work station. When a job is submitted 
from an RJE work station, it is processed by the host system in the same manner as 
any locally submitted job. When the job has completed processing, the output can 
be returned to the RJE work station, directed to another RJE work station, or 
directed to one of the output devices locally attached to the host system. 


Terms Related to Remote Job Entry 

Before you continue reading about System/36 MSRJE, there are several terms 

whose meanings you should know. You will frequently come across these terms in 

this guide and in other readings about remote job entry. 

• Job Control Language (JCL). All jobs submitted to the host system must 
contain job control language (JCL) statements to tell the host system what to 
do. JCL is the host system’s version of the System/36 Operator Control 
Language (OCL). JCL statements tell the host system what application 
program to start when the job is submitted from the RJE work station, where 
the output is to go, and also tells the host system how much of the computer 
resources (such as disk and main storage) are required by the job. 

• Data stream. A data stream is a group of records that relates to either an input 
or output device, or a group of records that relates to an input or output 
function. For example, data that is being sent to the host system is called a 
reader data stream because it will be viewed by the host system as card reader 
input. Print data that is received from the host system is called a print data 
stream; punch data received from the host system is called a punch data 
stream. 

• Host commands. These are commands sent by the RJE work station that tell 
the host system to do something, such as start a print output task or cancel a 
print task. 

• Session. (1) The logical connection by which programs or devices can 
communicate with each other. (2) The length of time that starts when an 
operator signs on to the system and ends when the operator signs off the 
system. 
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System/36 as a Remote Job Entry Work Station 


With the MSRJE feature, you can use System/36 as an RJE work station. Because 
System/36 does not support cards, the card reader input stream comes from either 
disk or from a display station keyboard. Before sending data to the host system, 
MSRJE ensures that, whether the data comes from a display station keyboard or 
disk, it will be acceptable to the host system as reader input. 

Display station input is much the same as card input because the input source 
documents are entered from a keyboard and converted to a format that can be read 
by the computer. However, instead of generating punched cards as a keypunch 
machine does, System/36 either stores the entered data in a disk file (that file can 
then become reader input to MSRJE) or submits the data directly to MSRJE, 
which then sends the data to the host system. 

When a punch data stream is received from the host system, MSRJE stores that 
data in a disk file. The disk file can then be used as input to another job (either a 
local System/36 job or an RJE job). 

When print data is received from the host system, MSRJE either prints it as it is 
received or writes it to a disk file for later printing by the MSRJE disk file utility 
(you control the destination of output received by MSRJE, as described in 
Chapter 3). 

In addition to transmitting data, MSRJE can also send Job Control Language 
(JCL) statements and commands to the host system. JCL and host system 
commands are not checked by MSRJE; they are simply sent. You must ensure the 
accuracy of JCL and host system commands before using them with MSRJE. 

MSRJE utility control statements control the operation of MSRJE. These 
statements are processed by MSRJE and a're not sent to the host system. The 
MSRJE utility control statements are described in Chapter 4. 


Use of MSRJE 


To illustrate an RJE application. Figure 1-2 shows a System/36 located at a 
regional office in Chicago and a host system located at corporate headquarters in 
New York. The regional office sends weekly sales totals Q to the host system, 
which processes the data and returns print data Q to the System/36 in Chicago. 
This data is then printed Q at the System/36. In addition to processing the reports 
for the Chicago office, the host system also updates the corporate sales files and 
generates weekly sales reports for corporate management Q, giving sales figures 
for the entire corporation. 

The System/36 in this example has communications and the MSRJE feature. An 
application program has been written to allow operators to enter sales invoices 
directly into a System/36 data file Q. A file has also been created that contains 
the JCL Q and commands needed by the host system to process the data and the 
utility control statements used to control the operation of MSRJE. 


1-4 Multiple Session Remote Job Entry Guide 




Figure 1-2. Example MSRJE Environment 

From Monday through Friday, the operators in Chicago enter the sales invoices 
into the data file on System/36. On Friday afternoon, MSRJE is started to send 
the collected data to the host system for processing. Once the data link is 
established, MSRJE reads the file that contains the MSRJE utility control 
statements and the host system JCL. The JCL is sent to the host system and the 
appropriate application is started there to process the sales data. The data file is 
then read by MSRJE and sent to the host system. Once the host application has 
processed the data, print data is returned to System/36 and printed. When all data 
has been sent, processed, and received, the System/36 operator ends MSRJE. 
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BSC Host Subsystems Supported by MSRJE 

Using MSRJE, System/36 can operate as an RJE work station when attached, 
through a data link on one or more System/36 lines, to the following BSC host 
subsystems: 

• Job Entry Subsystem 2 (JES2) running under MVS 

• Job Entry Subsystem 3 (JES3) running under MVS 

• Remote Entry Service (RES) running under OS/VSl 

• Remote Spooling Communications Subsystem (RSCS) running under VM/370 

SNA Host Subsystems Supported by MSRJE 

Using MSRJE, System/36 can operate as an RJE work station when attached, 
through a data link on one or more System/36 lines, to the following SNA host 
subsystems: 

• Job Entry Subsystem 2 (JES2) running under MVS 

• Job Entry Subsystem 3 (JES3) running under MVS 

• Virtual Storage Extended/Priority Output Writers, Execution Processors, and 
Input Readers (VSE/POWER) running under DOS/VSE 

• Remote Entry Service (RES) running under OS/VSl 

When MSRJE is used to communicate with an SNA host system, MSRJE can share 
a System/36 communications line with the following System/36 features: 

• The SSP-ICF SNA Upline Facility (SNUF) subsystem 

• SNA 3270 Device Emulation 

• The Distributed Systems Node Executive (DSNX) of Communications and 
Systems Management (C & SM) 

• The Distributed Host Command Facility (DHCF) of Communications and 
Systems Management 

• The SSP-ICF Advanced Program-to-Program Communications (APPC) 
subsystem 

Notes: 

1. More than one active SNA subsystem can share the same line, 

2. More than one remote location on the same line can be active to one or more 
hosts. 
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System/36 Requirements for Supporting MSRJE 


The minimum system configuration required to support MSRJE is: 

• System/3 6 with a minimum main storage of 128K bytes 

If throughput is important, you should use at least 256K bytes of main storage. 
Depending on other system activity (3270 Device Emulation, OFFICE/36), 
384K storage with 200 mb of disk is recommended. 

• Communications adapter 

• Communications equipment 

— Modem or an X.21 adapter 
— X.25 equipment 

— A switched or nonswitched communications line 

“ Protective couplers for a non-FCC registered modem on a switched line 
(US only) 

• System/36 System Support Program Product (SSP) 

• System/36 Communications feature 

Simultaneously, BSC MSRJE and SNA MSRJE can run on a total of eight 
communications lines. Separately, BSC MSRJE and SNA MSRJE can each run on 
up to eight communications lines. 
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utilities Provided with MSRJE 


In addition to the communications support provided by MSRJE, two utilities are 
provided with the MSRJE feature to aid you in your use of MSRJE. These utilities 
are the MSRJE disk file utility and the MSRJE control table utility. 

MSRJE Control Table Utility 

You use the MSRJE control table utility (named RJTABLE) to define how output 
received from the host system is to be handled during an MSRJE session. You 
create tables using the RJTABLE procedure command and name each entry in the 
table. The names you assign to the entries in the table correspond to forms names 
sent by the host system with output data. When a name in the table matches a 
received forms name, the values specified in the table are used to control the 
processing of the output data. If no match is found in the table, a default entry is 
used. You can define table entries for print data and punch data, and you can also 
update the print default and punch default entries. 

Using the control table allows you to specify whether print data received is to be 
written to a disk file containing 256-character unprocessed records, sent directly to 
the printer, spooled, or written to a user-defined disk file. You can specify that 
punch data be written to either a disk file as 256-character unprocessed records or 
a user-defined disk file. 

You can review and get a printout of the entire table or an entry in the table. 

The control table utility is described in Chapter 5. 


MSRJE Disk File Utility 

You use the MSRJE disk file utility (named RJFILE) to convert print data and 
punch data to printed output or data files after the data has been: 

• Received from the host system 

• Written to disk files that contain 256-character records 

Print data that was written to a disk file as 256-character unprocessed records (a 
compressed disk file) can be printed, or like punch data that was written to a 
compressed disk file, it can be converted to files you define. Punch data that was 
written to a compressed disk file can be converted to files you define, and you can 
use those files as input to application programs or MSRJE. 

The disk file utility is described in Chapter 6. 
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Defining MSRJE for System/36 and the Host System 


Before you can use MSRJE to communicate with a host system, you must: 

• Define the System/36 communications environment 

• Define the RJE environment for MSRJE to System/36 

• Define the RJE environment to the host system for communicating with 
MSRJE 

When you define the RJE environment for MSRJE to System/36, you are 
configuring MSRJE. When you are defining the RJE environment to the host 
system, you are generating the host system communications network. Some of the 
items defined during MSRJE configuration must match items defined during the 
host system, generation. You may either perform the host system generation and 
then base the MSRJE configuration on it, or perform the MSRJE configuration and 
then base the host system generation on the MSRJE configuration. In either case, 
you will have to work with the person who will be doing the host system generation 
to ensure that the MSRJE configuration and the host system generation match. 

Chapter 2 provides the information necessary to configure MSRJE. As you read 
Chapter 2, you will note that the items specified for MSRJE that must match values 
specified for the host system are so indicated. 

Chapter 7 describes the BSC host system generations; Chapter 8 describes the 
SNA host system generations. Whenever a value specified at the host system must 
match a value specified during MSRJE configuration, the corresponding MSRJE 
item is indicated. Appendix A contains host subsystem work sheets to help you 
during MSRJE configuration or host system generation. 
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Converting Systeni/34 SRJE or MRJE Applications to System/36 
MSRJE 


The IBM System/34 System Support Program Product (SSP) provides two separate 
utilities to perform remote job entry. MRJE (MULTILEAVING Remote Job 
Entry) supports communications with BSC host systems, and SRJE (SNA Remote 
Job Entry) supports communications with SNA host systems. In addition, 
System/34 provides utilities for defining the forms control table (DCFUP) and 
printing data written to a disk file (DCSUP). If you are converting from 
System/34 SRJE or MRJE, the manual Converting from System/34 to System/36 
contains information about converting to System/36 MSRJE. That manual also 
provides information about converting from DCFUP to the MSRJE control table 
utility, and from DCSUP to the MSRJE disk file utility. 


MSRJE and System/36 Resource Security 

If any of the files you intend to use with MSRJE are protected under the resource 
security capabilities of System/36, you must be sure that the operator who signs on 
to MSRJE is authorized to use those files. Security of files and libraries is based on 
the user ID and password. 

Whenever MSRJE attempts to access a file or library and the file or library is 
protected, the user ID is compared to the list of authorized users for that file or 
library. If the user is not authorized, a message is logged, and the file is not 
accessed. 

To ensure that MSRJE can access the forms control tables you create (as described 
in Chapter 5), you should authorize user MSRJE to have at least read access to the 
forms control table. 

The System Security Guide contains further information on resource security. 
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Chapter 2. Before Running MSRJE 


Before you can use MSRJE to communicate with a host system, you must: 

1. Install the MSRJE feature as a part of the system configuration 

2. Define a configuration for MSRJE 

Installing MSRJE 


MSRJE can be installed on System/36 during the initial system configuration, or 
when you change the system configuration. In either case, the CNFIGSSP 
procedure is used to describe your System/36 environment. 

MSRJE is installed during the program products definition of the SSP (System 
Support Program Product). The manual Changing Your System Configuration 
contains a complete description of installing the program products, including 
MSRJE. 
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Defining an MSRJE Configuration 


Defining a configuration for MSRJE consists of defining a line member and a 
subsystem member. 

Many of the values specified during MSRJE configuration must match values 
specified at the host system during generation of the communications network. For 
example, the number of readers, printers, and punches that can communicate with 
the host system at one time are defined during host subsystem generation. These 
values are also specified during MSRJE configuration. 

Host system work sheets are provided in Appendix A. It is suggested that you do 
either of the following: 

• Have the host system personnel provide you with the information for the work 
sheet and then use those values to configure MSRJE. 

• Fill out the work sheet yourself, configure MSRJE using the values you 
specified on the work sheet, and then provide that information to the host 
system personnel. They can then use it to generate the host communications 
network and subsystem. 

You define the System/36 line and subsystem members by entering the 
CNFIGICF procedure command from any command-capable display station. The 
command has no parameters. The CNFIGICF procedure then presents a series of 
displays that prompt you for the needed configuration information. 

When you are running the CNFIGICF procedure, you can request help text for all 
the displays by pressing the Help key. You start CNFIGICF by entering the 
CNFIGICF procedure command, which has no parameters. 


MSRJE Line Members 


A line member contains the description of the physical characteristics of the 
communications line that will be used by MSRJE and a description of one or more 
remote systems (host systems) with which MSRJE will communicate. The 
information in the line description is needed to establish the connection with the 
host system; it does not describe any specifics of the host subsystem or MSRJE. 
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One remote system can be defined within a line member for a nonswitched line; up 
to 32 remote systems can be defined within a line member for a switched line. In 
general, the remote system definition describes the characteristics of one host 
system. However, that host system could contain several subsystems, such as JES2, 
JES3, IMS, CICS, or RES. The remote system definition in the line member 
describes the characteristics of the host system (the computer itself) when 
System/36 is communicating with any of the host subsystems. 

The number of host systems you define depends entirely on your communications 
environment. For example, if you will be using MSRJE on a nonswitched line, or 
on a switched line to communicate with only one host system, you would define 
only that system. If you will be using MSRJE on a switched line and will be 
communicating with more than one host system, you would define each host 
system. 

Note that SNA MSRJE can use the same remote system definition as is used by: 

• SNA 3270 device emulation 

• SSP-ICF SNA Upline Facility (SSP-ICF SNUF) for application programs 

• Distributed Systems Node Executive (DSNX) of Communications and System 
Management (C & SM) 

• SSP-ICF Advanced Program-to-Program Communications (APPC) 

• Distributed Host Command Facility (DHCF) of C & SM. 

The manual Using System/36 Communications contains information on defining 
line members. 
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MSRJE Subsystem Members 


A subsystem member contains the information necessary for MSRJE to 
communicate with one or more remote locations. For MSRJE, a remote location 
definition describes the characteristics of one RJE subsystem (such as JES2 or 
RES) in a host system (a remote system in the line member). Actually, since the 
host system can have many RJE work stations defined, an MSRJE remote location 
describes one work station for one host system. 

When you define a subsystem member, you must specify the name of the line 
member that is to be used by the subsystem member. You then define one or more 
remote locations for each of the remote systems within the line member. When 
defining a subsystem member, you are shown the names of the remote systems that 
are defined within the associated line member. You then specify the name of the 
remote system for which you are defining a remote location. 

You specify the following during the definition of a remote location: 

• The name of the remote location. This name is used on the ENABLE and 
MSRJE procedure commands. 

For SNA, more than one location can be specified. You can then communicate 
with more than one location at a single remote system on a line. 

• Whether the location is to be activated when an ENABLE procedure command 
specifying the subsystem member, but no location name, is entered. 

• The name of the host system. 

• How long MSRJE is to wait before ending a session after the MSRJE console 
has been released and all readers, printers, and punches have ended. 

• The priority assigned to MSRJE readers, printers, and punches. 

• The host system logon/signon information. 

• The MSRJE configuration, including: 

- The number of MSRJE readers, printers, and punches. 

- The number of readers defined for MSRJE at the host system. 

- The sequence number to be assigned to print or punch files generated by 
MSRJE. 

- The forms control table and forms set to use. 

- Whether text transparency can be used. 

~ Default values for certain parameters on the MSRJE procedure command. 

- For SNA MSRJE, the maximum number of sessions allowed by the host 
system. 

~ For SNA MSRJE, the minimum number of sessions allowed. (MSRJE 
terminates if the number of active sessions is less than this value.) 
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Examples of MSRJE Configurations 

The following illustrations show the relationship between line members, remote 
systems, subsystem members, and remote locations. In all of the examples, the line 
and subsystem members are stored in a user library named RJELIB (a subsystem 
member and its associated line member must be stored in the same library). 

The first illustration shows a System/3 6 using MSRJE on a nonswitched line 
(System/36 line 1) to communicate with a BSC host system running RES. A line 
member (named BSCLINEl) with one remote system (named BSCHOSTl) and a 
subsystem member (named BSCSUBl) with one remote location (named 
BSCLOCl) have been defined. The following ENABLE command is used to 
activate the communications support and the remote location: 


ENABLE BSCSUB1,RJELIB,1,,BSCLOC1 

System/Se Host System 



S7909002-0 


The next illustration shows a System/36 using MSRJE on a switched line to 
communicate with two SNA host systems (one is running JES2 and the other 
RES). The line member is named SNASWT2, the remote systems are named 
SNARES and SNAJES2, the subsystem member is named SNASUB2, and the two 
remote locations (one for each remote system) are named JES2LOC and 
RESLOC. 
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First, the line and subsystem member are used to communicate with the JES2 
subsystem: 

ENABLE SNASUB2,RJELIB , 2 ,, JES2LOC 


System/36 


SNASUB2 


JES2LOC 

RESLOC 


SNASWT2 

SNAJES2 

SNARES 


1 


Host System 


Line 

1 

Line 

2 

Line 

3 

Line 

4 

Line 

5 

Line 

6 

Line 

7 

Line 

8 



Then, the same line and subsystem member are used to communicate with the RES 
subsystem: 

ENABLE SNASUB2,RJELIB , 2 ,,RESLOC 


System/36 Host System 



S7909004-0 
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Defining an MSRJE Subsystem Member Configuration for BSC 


During subsystem member configuration, you describe, for each remote system 
specified in a line member, the local (System/36) characteristics of MSRJE. (The 
manual Using System/36 Communications contains information on defining line 
members.) Many local characteristics are affected by what has been specified for 
communicating with MSRJE by the host system. 

You should refer to the host system v/ork sheets (in Appendix A) during subsystem 
configuration. You will have to use the values provided on the work sheet by the 
host system personnel, or you will need to enter the values on the work sheet and 
give it to the host system personnel. 

In the following example, the subsystem member is named BSCSUBl and the 
remote location is named BSCLOCl. This subsystem member is associated with 
the line member BSCLINEl. 

Display 1.0 SSP-ICF Configuration Member Definition 




1.0 


SSP-ICF CONFIGURATION MEMBER DEFINITION 



1. Configuration member name . 

2. Library name.RJELIB 

3. Select one of the following: 

1. Create new member 

2. Edit existing member 

3. Create new member from existing member 

4. Remove a member 

5. Review a member 

Option.1-5 


Cmd7-End Cmdl9-Cancel 


Help text available throughout CNFIGICF by pressing the Help key 


Note: On this display and on all displays that follow, you can press command key 7 
to end the CNFIGICF procedure or command key 19 to cancel the 
CNFIGICF procedure. Command key 7 saves any valid definitions you have 
performed; command key 19 immediately ends CNFIGICF, and you lose any 
definitions you have performed but not saved. 
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1. Configuration member name: Specify a name for this subsystem member. The 
name is used to store the member in a library and is referenced by the 
ENABLE and DISABLE procedure commands (these commands are 
described in Chapter 3). In the example, BSCSUBl is used. 

2. Library name: Specify the name of the library in which you want this member 
stored. The default library is the current user library (RJELIB in the 
example). It is recommended that you do not store the member in the system 
library (#LIBRARY) because members you store in #LIBRARY may be lost 
if a release update is later performed. 

The subsystem member must be stored in the same library as the line member 
with which it will be associated. 

3. Select one of the following: Specify the number (1 through 5) that 
corresponds to the operation you want to perform. The options are: 

1. Create a new member allows you to specify the configuration values for a 
new subsystem member. 

2. Edit existing member allows you to view and/or change the values 
previously specified for a subsystem member. 

3. Create a new member from an existing member allows you to use an 
existing subsystem member as the basis for a new subsystem member. 

You need change only those values necessary. The existing member is 
not changed. 

4. Remove a member allows you to remove a subsystem member from the 
library. Note that the definition is no longer available once it is removed. 

5. Review a member allows you to view the values specified for a subsystem 
member. No changes can be made. 

If you select option 3 for prompt 3, display 1.0 is updated with two additional 
prompts when you press the Enter key. If you select any other option, display 2.0 is 
presented. 

Because a new subsystem member is being created in the example, the next display 
would be display 2.0. However, to illustrate how display 1.0 is updated if option 3 
is selected for prompt 3, the next display described is the updated version of 
display 1.0. 
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SSP-ICF CONFIGURATION MEMBER DEFINITION 


W1 


1 .0 


1. Configuration member name . BSCSUB1 

2. Library name.RJELIB 


3. Select one of the following: 

1. Create new member 

2. Edit existing member 

3. Create new member from existing member 


4. Remove a member 

5. Review a member 

Option.1-5 3 

4. Existing member name . 

5. Existing member library name . RJELIB 


Cmd7-End Cmdl9-Cancel 




Existing member name: This prompt appears only if option 3 was selected for 
prompt 3. Specify the name of the existing subsystem member that you want 
to use as the basis for a new subsystem member. 

Existing member library name: This prompt appears only if option 3 was 
selected for prompt 3. The default is the name specified for prompt 2 
(RJELIB). Specify the name of the library in which the member named in 
prompt 4 is stored. 
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I Display 2.0 SSP-ICF Configuration Member Type 


I 



SSP-ICF CONFIGURATION MEMBFR TYPE 


Select the member type from the followipg options: 

1. INTRA 

2. BSC 

3. SNA 

4. ASYNC 


Option 


BSCSUB1 W1 


1-4 


Cmd3-Previous display 



Cmdl9-Cancel 

COPR IBM Corp. 1986 



Note: On this display and all displays that follow for subsystem member 

configuration, the member name (BSfCSUPl), as specified for prompt 1 on 
display 1.0, is shown in the upper right-hand corner. Pressing command key 3 
returns you to the previous displayj 

Select one of the following options: Specify the type of protocol that you are 
defining. Select option 2 (BSC). 


I Display 3,0 BSC Configuration Member Type 



3.0 SSP-ICF CONFIGURATION ME;MBER TYPE 

1 . BSC member type. . .1,2 


1. BSC subsystem member 

2. BSC line member 



Cmdl9-Cancel 

COPR IBM Corp. 1986 


I 1. BSC member type: Specify the type of meipber that you are defining. Select 

I option 1 (BSC subsystem member). 
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Display 20.0 BSC Subsystem Member Selection 



1. Line member name: Specify the name of the line member with which this 
subsystem member is to be associated. The line member name was specified 
on display 1.0 during line member configuration. 

For the example, the subsystem member is associated with the BSC line 
member named BSCLINEl. 

2. Select subsystem type from the following options: Specify option 6 (BSC 
MSRJE). 

When you complete display 20.0 and press the Enter key, you begin defining the 
local characteristics of MSRJE, beginning with display 29.0. 
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Display 29.0 Remote Location Selection 




29.0 


REMOTE LOCATION SELECTION 


1. Select from the following options: 

1-Create 

Option . 

2. Remote location name . 

3. Remote system name . 

4. Existing location name . 


OPTION LOCATION REMOTE SYSTEM 

BSCHOST1 



Page 1 of 1 


CmdS-Reset Cmdl9-Cancel 

No remote locations are configured 



Roll-Page ^ 


1. Select from the following options: 

1- Create. Define a new location. 

Note: If no remote locations exist within the remote system, option 1, 

Create, is the only option available. 

2- Edit. Change an existing location. 

3- Create from existing. Define a new remote location using an existing 

remote location as the base. 

4- Remove. Delete a remote location. It will no longer exist in this 

member. 

5- Review. Display an existing remote location. 

2. Remote location name: Enter the name of the remote location that this 
subsystem communicates with. This name is used in the ENABLE, DISABLE, 
and MSRJE procedures to start or stop communications with this remote 
location. This name also appears in system messages to help the operator 
associate the message with a particular remote location. No two remote 
location names can be the same in this subsystem member. 

3. Remote system name: Enter the name of the remote system for which this 
remote location is being defined. 

4. Existing location name: Enter an existing location name if you are using option 
3 to create a new remote location using an existing location as the base. 
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On the bottom half of the display, all previously defined remote locations are listed 
along with the remote systems they are associated with. You may edit, remove, or 
review any of these remote locations by entering the correct option number in the 
column to the left of the remote location you want to work with. Use the Roll keys 
to page through the list of remote locations. 

Display 30.0 Remote Location Definition 



The name you specified for the Remote system prompt on the previous display 
is presented here (BSCHOSTl in the example). 

The Remote location name specified here is used in the MSRJE, ENABLE, 
and DISABLE procedure commands when you want to communicate with 
this remote system. (See Chapter 3 for a description of these procedure 
commands.) In the example, the remote location is named BSCLOCl. 

Note: The remote system name and the remote location name are presented for 
information only. They cannot be changed on this display. 

1. Activate location at ENABLE?: Specify Y if you want the remote location 
enabled when the ENABLE procedure command (without a remote location 
name specified) is entered that specifies this subsystem member. If you 
specify N for this prompt, you must enable the remote location by specifying 
the Remote location name on an ENABLE procedure command. 

The ENABLE procedure command is described in Chapter 3. 

On each of the following displays, the remote system name (BSCHOSTl in the 
example) and the remote location name (BSCLOCl in the example) are displayed 
below the display heading. 
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Display 34.0 MSRJE Subsystem Member Attributes 



1. Hostname: Specify the name of the host system with which this 

configuration record is to be used to communicate. Valid entries are; 

. JES2 for JES2 under MVS 

. JES3 for JES3 under MVS 

. RES for RES under OS/VS 1 

. VM370 for VM370 RSCS 

In the example, RES is used. 


if '\ 
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2. Termination delay in minutes: Specify the length of time, in minutes, that 
MSRJE will remain active after all readers, printers, and punches have 
finished and the MSRJE console has been released. Valid values are 00 
through 99 or blank. If blank is specified, MSRJE will not terminate 
automatically and must be terminated by entering the MSRJE END utility 
control statement or the DISABLE procedure command. 

3. Priority: Specify the priority level that is to be assigned to readers, printers, 
and punches activated by MSRJE. N (normal) is the default. All priority 
values correspond to your definitions of priority levels on the 

// ATTR OCL statement. The valid selections are: 

• H for high priority 

• N for normal job priority 

• M for medium priority 

• L for low priority 

The MSRJE console always has high (H) priority. 

For a description of the // ATTR OCL statement, see the manual 
Procedures and Commands Summary, 

6, Display informational messages?: If you specify Y (Yes) for this prompt, all 
MSRJE informational messages are displayed on the MSRJE console. These 
messages inform the MSRJE operator of local MSRJE activities. This prompt 
does not control messages received from the remote host system. 

When you complete display 34.0 and press the Enter key, display 35.0 appears to 
prompt you for the host system signon/logon information. 
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Display 35.0 MSRJE Logon Attributes 



The information specified for the logon/signon must match what the host system is 
expecting. The following formats are general for the supported host systems. 

Refer to the host system work sheet (in Appendix A), or contact the host system 
personnel to determine the exact format of the information. 

3. Enter host LOGON/SIGNON command below: Specify the LOGON or 
SIGNON command that is required by the host system with which this 
configuration of MSRJE will be communicating. The formats for the 
supported host systems are: 

. JES2 


/*SIGNON iREMOTEnnI [passwordi] [password2] 

|RMTnn J 

S7909035-0 

The command begins in position 1. The REMOTEnn or RMTnnn 
parameter begins in position 16 and specifies the terminal number of 
System/36 as specified by the RMTnnn parameter of the JES2 work 
station definition. 

The passwordi parameter is optional and, if used, must be 1 through 8 
alphameric characters beginning in position 25 and must match the 
password specified for the PASSWORD subparameter of the LINEnnn 
parameter during the definition of remote work stations for JES2 at the 
host system. 
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The password2 parameter is optional and, if used, is 1 through 8 
alphameric characters beginning in position 73 and must match the value 
specified for the PASSWORD parameter of the RMTnnn parameter 
during remote work station definition for JES2 at the host system. 

• JES3 

/♦SIGNON namex [A] passwordi password2 

The command begins in position 1. The namex parameter begins in 
position 16 and must match the value specified for the N parameter in the 
RJPTERM statement during JES3 generation at the host system. 

The A is optional and, if used, must be in position 22. It identifies 
System/3 6 to the host system as being a programmable RJE work station 
with automatic readers. 

The passwordi parameter must be 1 through 8 alphameric characters 
beginning in position 25. It must match the value specified for the P 
parameter in the RJPLINE statement at the host system. 

The passwordi parameter begins in position 35. It is 1 through 8 
alphameric characters and must match the value specified for the P 
parameter in the RJPTERM statement at the host system. 

. RES 

LOGON userid[ /password]TERM(termid)[PROG(procname) ] 


Tnotices 1 

r MAIL \ 

\^NONOTICESJ 

\NOMAILj 


S7909008-0 

The command begins in position 1. The userid parameter identifies 
System/3 6 to the host system, and must match the value specified at the 
host system for the ADD subcommand of the ACCOUNT command. 

The password parameter is optional and, if used, is 1 through 8 
alphameric characters and must be separated from the userid by a slash 
(/). In addition, the value must match the entry made in the ADD 
subcommand for the specified user. 

TERM(teriiiid) specifies the terminal identification number and must 
match the value entered for the TERMID parameter for System/3 6 in 
the TERMINAL macro for the RTAM generation at the host system. 

The PROC(procname) allows you to specify a catalogued procedure 
(procname) at the host system that is to be executed as a part of the 
logon process. 

NOTICES, the default, allows you to specify that all general notices from 
the host system are to be listed automatically after logon. NONOTICES 
inhibits the listing of notices. 
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MAIL, the default, allows you to specify that all messages directed to 
your System/36 be automatically listed after logon. NOMAIL inhibits 
the listing of messages. 

* VM/370 RSCS 

/♦SIGNON REMOTEnn [password] 

The command begins in position 1. The REMOTEnn parameter begins in 
position 16 and defines the remote terminal number of System/3 6 as 
defined in the START command at the host systerii. 

The password parameter is optional and, if used, is 1 through 8 alphameric 
characters beginning in position 25 and must match the password specified 
at the host system in the START command for this terminal. 

Because the example is for communicating with RES, the value entered is: 

LOGON USER1/PASS1 TERM(21) PROC(MRJEPROC) 


V 


After you press the Enter key, you define the MSRJE environment by completing 
the information on displays 36.0 and 37.0. 
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Display 36.0 MSRJE Printer/Punch Attributes 


36.0 MSRJE PRINTER/PUNCH ATTRIBUTES 

Remote system BSCHOST1 Remote location BSCLOC1 


BSCSUB1 W1 


1. Forms control table name . 

2. Forms set.0-8 0 

3. Maximum number of printers.0-7 01 

4. Printer file sequence number. 1-99 01 

5. Maximum number of punches.0-7 01 

6. Punch file sequence number. 1-99 01 


Cmdl9-Cancel 



The entries on display 36.0 define the printers and punches used for MSRJE. 

1. Forms control table name: Specify the name of the forms control table that is 
to be used with this MSRJE configuration to control the handling of print and 
punch data streams received from the host system. The forms control table is 
created by the MSRJE forms control table utility (see Chapter 5 for 
information on the forms control table utility). 

If you do not specify a name for this prompt, MSRJE handles print and punch 
data streams as described in the “Print Default Entry” and “Punch Default 
Entry” sections of Chapter 5. 

2. Forms set: Define the use of host forms information from the forms set table. 
This internally maintained table contains entries for all print and punch 
devices supported by MSRJE. Use of the table allows MSRJE to save the 
forms mounted for each device from LOGOFF of one session to LOGON of 
another session. This is useful if the host system views System/36 as the type 
of device that keeps the same form mounted all the time. 

Valid entries are 0 through 8; 0 is the default. If 0 is specified, MSRJE will 
not maintain a forms set table for this location and, therefore, will not 
maintain the forms names between sessions. Because the table can contain 
the definitions of forms for up to eight separate host systems, the value 
entered here defines which set you want used when this configuration is 
active. 

If the same forms set (other than 0) is specified in different MSRJE 
configurations, unexpected results may occur. 

Note: Initially, the forms name for all devices of all forms sets is all blanks. 
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3. Maximum number of printers: Specify the maximum number of printer tasks 
that can be active. Enter a value from 0 through 7; the default is 01. This 
value must be at least as large as the number of printers specified at the host 
system for this MSRJE configuration. 

The value for the number of printers is specified at the host system as 
follows: 

• JES2, specified in the NUMPR subparameter of the RMTnnn parameter 
on the JES2 work station definition 

• JES3, specified in the PR subparameter of the RJPTERM parameter on 
the JES3 work station definition 

• RES, specified in the PTRS parameter of the TERMINAL macro for the 
RTAM stage 1 generation 

• VM/370 RSCS, always 0 or 1, depending on whether you expect print 
output 

If the host system work sheet has been filled out, refer to it for the correct 
value. If you are configuring MSRJE before the host system is generated, 
enter the Maximum number of printers on the work sheet. 

The total number of printers (specified here) and punches (specified for 
prompt 5) must be 8 or less. 

4. Printer file sequence number: Specify a number from 01 through 99 to define 
the beginning sequence number for printer files written to disk; the default is 
01. See Chapter 3 for a description of print output, and see Chapter 5 for a 
description of the forms control table entries that control print data written to 
disk. 

5. Maximum number of punches: Specify the maximum number of punch tasks 
that can be active. Enter a value from 0 through 7; the default is 01. This 
value must be at least as large as the number of punches specified at the host 
system for this MSRJE configuration. 

The value for the number of punches is specified at the host system as 
follows: 

• JES2, specified in the NUMPU subparameter of the RMTnnn parameter 
on the JES2 work station definition 

• JES3, specified in the PU subparameter of the RJPTERM statement on 
the JES3 work station definition 

• RES, specified in the PCHS parameter of the TERMINAL macro for the 
RTAM stage 1 generation 

• VM/370 RSCS, always 0 or 1, depending on whether you expect punch 
output 
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If the host system work sheet has been filled out, refer to it for the correct 
value. If you are configuring MSRJE before the host system is generated, 
enter the Maximum number of punches on the work sheet. 

The total number of punches (specified here) and printers (specified for 
prompt 3) must be 8 or less. 

6. Punch file sequence number: Specify a number from 01 through 99 to define 
the beginning sequence number for punch files written to disk; the default is 
01. See Chapter 3 for a description of punch output, and see Chapter 5 for a 
description of the forms control table entries that control punch data written 
to disk. 

Once you press the Enter key, the last display, display 37.0, is presented. 
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Display 37.0 MSRJE Reader Attributes 


37.0 MSRJE READER ATTRIBUTES BSCSUB1 

Remote system BSCHOST1 Remote, location BSCLOC1 

1. Maximum number of MSRJE readers. 1--32 01 

2. Maximum number of host readers.1-7 01 

3. Transparency?.Y,N N 

4. Specify default value for TYPE . P,D,S P 

5. Specify default value for CMD ..Y,N Y 

6. Specify default value for DEL.Y,N N 

Cmd19-Cancel 


W1 


Display 37.0 allows you to define the readers used by MSRJE and defined at the 
host system. 

1. Maximum number of MSRJE readers: Specify the number, from 1 through 
32, of readers that can be active at one time for this MSRJE configuration. 

The default is 1. 

V. y 

By specifying a value that is greater than the value specified for the Maximum 
number of host readers prompt, you can start MSRJE readers and then allow 
them to wait for a host reader to become available. 

The number of readers that you specify here depends on your RJE 
environment. For example, if several users will be signing on to MSRJE and 
sending data files to the host subsystem, you should specify as many readers 
as you expect will be needed at one time. If all the host readers (prompt 2, 

Maximum number of host readers) are in use, MSRJE will display a message 
and allow you to wait for a host reader to become available. You do not have 
to re-enter a request to start a reader. 
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2, Maximiun number of host readers: Specify the maximum number of readers 
that can be sending data to the host system at one time. The value entered 
can be from 1 through 7; the default is 1. This value should not exceed the 
number of readers specified for the host during host system generation. The 
maximum number of readers is specified at the host subsystems as follows: 

^ JES2, specified in the NUMRD subparameter of the RMTnnn parameter 
on the JES2 work station definition 

• JESS, specified in the RD subparameter of the RJPTERM statement on 
the JESS work station definition 

• RES, specified in the RDRS parameter of the TERMINAL macro for the 
RTAM stage 1 generation 

• VM/S70 RSCS, always 1 

If the host system work sheet has been filled out, refer to it for the correct 
value. If you are configuring MSRJE before the host system is generated, 
enter the Maximum number of host readers on the work sheet. 

3. Transparency?: Specify whether text transparency can be used with this 
MSRiE configuration. N, the default, specifies that text transparency cannot 
be used. Y specifies that text transparency can be used. 

Transparency is normally used if you will be sending and receiving data that 
contains data characters, which could be handled as control characters by the 
BSC protocol Normally, this occurs in object modules (load members) or 
binary data streams. 

Whether you can use transparency depends on the value specified at the host 
subsystem, as follows: 

• JES2, specified in the TRANSP/NOTRANSP subparameter of the 
LtNEnnn parameter (defines whether the line supports transparency); 
and in the TRANSP/NOTRANSP subparameter of the RMTnnn 
parameter (defines whether System/36 can use transparency) 

• JES3, specified in the F subparameter of the RJPTERM parameter. 
Fa±)>JTRS specifies no transparency. Transparency is supported if 
FsaNTRS is not specified. 

• RES, subparameter 2 of the LDESCR parameter in the LINE macro 
defines whether the line supports transparency; subparameter 4 of the 
TDESCR parameter of the TERMINAL macro determines whether 
System/36 can use transparency. Both macros are defined for the 
RTAM stage 1 generation. 

• VM/370 RSCS, always sends punch data in transparent text mode and 
accepts transparent data. 

If the host system work sheet has been filled out, refer to it for the correct 
value. If you are configuring MSRJE before the host system is generated, 
entef your response to the Transparency? prompt on the work sheet. 
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4. Specify default value for TYPE: Specifies the default value to be used for the 
TYPE parameter on the MSRJE procedure or in READFILE utility control 
statements entered when this configuration is active. Specifying a value here 
is useful if most MSRJE procedure or READFILE statements you use will 
have the same TYPE parameter value. Refer to “Starting an MSRJE 
Session” in Chapter 3 or “READFILE Utility Control Statement” in 
Chapter 4 for a complete description. 

Valid entries are: 

• P for a procedure member 

• D for a disk file 

• S for a source member 

5. Specify default value for CMD: Specify the default value to be used for the 
CMD parameter on the MSRJE procedure or in the READFILE MSRJE 
control statement for utility control statements entered when this 
configuration is active. Y indicates that the file contains utility control 
statements (utility control statements are described in Chapter 4); N indicates 
that the file does not contain utility control statements. 

Specifying a value here is useful if most MSRJE procedure or READFILE 
statements you use will have the same CMD parameter value. Refer to 
“Starting an MSRJE Session” in Chapter 3 or “READFILE Utility Control 
Statement” in Chapter 4 for a complete description. 

6. Specify default value for DEL: Specifies the default value to be used for the 
DEL parameter on the MSRJE procedure or in the READFILE utility 
control statement if no specification is made in the command for the 
parameter. Y specifies that deleted records in the file are to be transmitted to 
the host system. N specifies that deleted records in the file are not to be 
transmitted to the host system. 

Specifying a value here is useful if most MSRJE procedure or READFILE 
statements you use will have the same DEL parameter value. Refer to 
“Starting an MSRJE Session” in Chapter 3 or “READFILE Utility Control 
Statement” in Chapter 4 for a complete description. 

Once you have completed display 37.0, display 29.0 is again displayed, and you can 
then define another MSRJE configuration. To end the definition of MSRJE 
configurations, press command key 7. Display 1.0 is then presented, and you can 
either define another line or subsystem member, or end the CNFIGICF procedure 
by pressing command key 7. 
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Defining an MSRJE Subsystem Member Configuration for SNA 


During subsystem member configuration, you can describe, for each remote system 
specified in a line member, the local (System/36) characteristics of MSRJE. (The 
manual Using System/36 Communications contains information on defining line 
members.) Many local characteristics are affected by what has been specified at the 
host system for communicating with MSRJE. 

You should refer to the host system work sheets (in Appendix A) during subsystem 
configuration. You will have to use the values provided on the work sheet by the 
host system personnel, or you will need to enter the values on the work sheet and 
give it to the host system personnel. 

In the following example, the subsystem member is named SNASUBl and the 
remote location is named SNALOCl. This subsystem member is associated with 
the line member SNALINEl. 

Display 1.0 SSP-ICF Configuration Member Definition 


1 .0 


SSP-ICF CONFIGURATION MEMBER DEFINITION 


1. Configuration member name 

2. Library name . 


3. Select one of the following: 


1 

2 . 

3. 

4. 

5. 

Option 


Create new member 
Edit existing member 

Create new member from existing member 
Remove a member 
Review a member 


1-5 


Cmd7-End Cmdl9-Cancel 

Help text available throughout CNFIGICF by pressing the Help key 


On this display and on all displays that follow, you can press command key 7 to 
end the CNFIGICF procedure or command key 19 to cancel the CNFIGICF 
command. Command key 7 saves any valid definitions you have performed; 
command key 19 immediately ends CNFIGICF, and you lose any definitions you 
have performed but not saved. 
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1 . Configuration member name: Specify a name for this configuration of the 
subsystem. This name is used to store the member in a library and is 
referenced in the ENABLE and DISABLE procedure commands. In the 
example, the subsystem member is named SNASUBL 

2. Library name: Specify the name of the library in which you want this member 
stored. The default is the current user library (RJELIB in the example). You 
can use that library or specify the name of another user library. It is 
recommended that you do not store the member in the system library 
(#LIBRARY). If you store the member in #LIBRARY, it may be destroyed 
if a System/36 release update is performed. 

The library specified here must be the same library in which the associated 
line member (SNALINEl in the example) is stored. 

3. Select one of the following: Specify the number (1 through 5) that 
corresponds to the operation you want to perform. The bptions are: 

1. Create a new member allows you to specify the configuration values for a 
new subsystem member. 

2. Edit existing member allows you to view and/or change the values 
previously specified for a subsystem member. 

3. Create a new member from an existing member allows you to use an 
existing subsystem member as the basis for a new subsystem member. 
You need change only those values necessary. The existing subsystem 
member is unchanged by this option. 

4. Remove a member allows you to remove a subsystem member from the 
library. Note that the definition is no longer available once it is removed. 

5. Review a member allows you to view the values specified ^or a subsystem 
member. No changes can be made. 

If option 3 is selected for prompt 3, this display is updated with two additional 
prompts when the the Enter key is pressed. If any other option is selected, display 
2.0 is presented. 

Because a new subsystem member is being created in the example^ the next display 
would be display 2.0. However, to illustrate how display 1.0 is updated if option 3 
is selected for prompt 3, the next display described is the updated Version ot 
display LO. 
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SSP-ICF CONFIGURATION MEMBER DEFINITION 


1. Configuration member name . SNASUB1 

2. Library name.RJELIB 


3. Select one of the following: 

1. Create new member 

2. Edit existing member ' 

3. Create new member from existing member 


4. Remove a member 

5. Review a member 

Option.1-5 3 

4. Existing member name . 

5. Existing member library name . RJELIB 


Cmd7-End Cmd19-Cancel 






4. Existing member name: This prompt appears only if option 3 was selected for 
prompt 3. Specify the name of the existing subsystem member that you want 
to use as the basis for the new subsystem member. 

5. Existing member library name: This prompt appears only if option 3 was 
selected for prompt 3. Specify the name of the library in which the member 
named in prompt 4 is stored. The default is the value specified for prompt 2 
(RJELIB in the example). 
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I Display 2.0 SSP-ICF Configuration Member Type 


I 



SSP-ICF CONFIGURATION MEMBER TYPE 


Select the member type from the following options: 

1. INTRA 

2. BSC 

3. SNA 

4. ASYNC 


Option 


SNASUB1 


W1 


1-4 


Cmd3-Previous display 



Cmdl9-Cancel 

COPR IBM Corp. 1986 


Note: On this display and all displays that follow for subsystem member 

configuration, the member name (SNASUBl), as specified for prompt 1 on 
display 1.0, is shown in the upper right-hand corner. Pressing command key 3 
returns you to the previous display. 

Select the member type from the following options: Specify the type of protocol that 
you are defining. Select option 3 (SNA). 


1 Display 4.0 BSC Configuration Member Type 


4.0 


SNA CONFIGURATION MEMBER TYPE 


SNASUBl 


Wl 


1 . SNA member type. 1/2,3 

1. SNA subsystem member 

2. SNA/SDLC line member 

3. SNA/X.25 line member 


Cmdl9-Cancel 

COPR IBM Corp. 1986 


1. SNA member type: Specify the type of member that you are defining. Select 
option 1 (SNA subsystem member). 
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Display 21.0 SNA Subsystem Member Selection 



SNA SUBSYSTEM MEMBER SELECTION 


1. Line member name . . . 

2. Select subsystem type: 

1. Peer 

2. SNA Upline 

3. SNA 3270 

4. Finance 

5. SNA MSRJE 

6. APPC 

Option . 


SNASUB1 


1-6 


Cmd3-Previous display Cmdl9-Cancel 



1. Line member name: Specify the name of the line member with which this 
subsystem member is to be associated. The line member name was specified 
on display 1.0 during line member configuration. 

For the example, the subsystem member is associated with the SNA line 
member named SNALINEl. 

2. Select subsystem type: Specify option 5 (SNA MSRJE). 

When you complete display 21.0 and press the Enter key, you begin defining the 
local characteristics of MSRJE, beginning with display 29.0. 
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Display 29.0 Remote Location Selection 




REMOTE LOCATION SELECTION 


1. Select from the following options: 
1-Create 


Option . 

2. Remote location name 

3. Remote system name . 


OPTION LOCATION REMOTE SYSTEM 
SNAHOST1 


SNASUB1 



1 


Page 1 of 1 


Cmd8-Reset Cmdl9-Cancel Roll-Page 

No remote locations are configured 




1. Select from the foUowing options: 

1- Create. Define a new location. 

Note: If no remote locations exist within the remote system, option 1, 

Create, is the only option available. 

2- Edit. Change an existing location. 

3- Create from existing. Define a new remote location using an existing 

remote location as the base. 

4- Remove. Delete a remote location. It will no longer exist in this 

member. 

5- Review. Display an existing remote location. 

2. Remote location name: Enter the name of the remote location that this 
subsystem communicates with. This name is used in the ENABLE, DISABLE, 
and MSRJE procedures to start or stop communications with this remote 
location. This name also appears in system messages to help the operator 
associate the message with a particular remote location. No two remote 
location names can be the same in this subsystem member. 

3. Remote system name: Enter the name of the remote system for which this 
remote location is being defined. 

On the bottom half of the display, all previously defined remote locations are listed 
along with the remote systems they are associated with. You may edit, remove, or 
review any of these remote locations by entering the correct option number in the 
column to the left of the remote location you want to work with. Use the Roll keys 
to page through the list of remote locations. 
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Display 30.0 Remote Location Definition 


30.0 


REMOTE LOCATION DEFINITION 


SNASUB1 


Remote system SNAHOST1 


Remote location SNALOC1 


1. Activate location at ENABLE? 


Y,N Y 



Cmdl9-Cancel 



The name you specified for the Remote system prompt on display 29.0 is presented 
here (SNAHOSTl in the example). 

The Remote location name specified here is used in the MSRJE, ENABLE, and 
DISABLE procedure commands when you want to communicate with this remote 
system. (See Chapter 3 for a description of these procedure commands.) In the 
example, the remote location is named SNALOCl. 

Note: The remote system name and the remote location name are presented for 
information only. They cannot be changed on this display. 

1. Activate location at ENABLE?: Specify Y if you want the remote location 
enabled when the ENABLE procedure command (without a remote location 
name specified) is entered that specifies this subsystem member. If you 
specify N for this prompt, you must enable the remote location by specifying 
the Remote location name on an ENABLE procedure command. 

The ENABLE procedure command is described in Chapter 3. 

More than one remote location can be active on the same line for SNA 
MSRJE. This means that you can have more than one RJE terminal active to 
one or more remote locations at one remote (host) system. 

On each of the following displays, the remote system name (SNAHOSTl in the 
example) and the remote location name (SNALOCl in the example) are displayed 
below the display heading. 
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Display 34.0 MSRJE Subsystem Member Attributes 



1. Host name: This entry is optional. You use it to specify the name of the host 
system for this remote location. If you do not specify a name, MSRJE 
accepts any application name when MSRJE is started. If you specify a name, 
MSRJE is started only if the name you specify matches the application name 
received from the host system. 

The name you specify must match: 

• The APPLID parameter (if used) in the LOGON command 

• The label on the VTAM APPL definition statement of the VTAM 
application definition 

• The following, based on the subsystem: 

— For JES2, the APPLID subparameter of the LOGONl initialization 
parameters 

- For JESS, the APPLID parameter of the COMMDEFN macro 

- For RES, the APPLID parameter of the RTAM macro 

— For VSE/POWER, the third positional subparameter of the SNA 
parameter of the POWER macro 

2. Termination delay in minutes: Specify the length of time, in minutes, that 
MSRJE will remain active after all readers, printers, and punches have 
finished and the MSRJE console has been released. Valid values are 00 
through 99 or blank. If blank is specified, MSRJE will not terminate 
automatically and must be terminated by entering the MSRJE END utility 
control statement or using the DISABLE procedure command. 

Note: Command key 7 ends the MSRJE console or reader at the display 
station, but the subsystem remains active. 
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3. Priority: Specify the priority level that is to be assigned to tasks activated by 
MSRJE. N (normal) is the default. All priority values correspond to your 
definitions of priority levels on the // ATTR OCL statement. The valid 
selections are: 

• H for high priority 

• N for normal job priority 

• M for medium priority 

• L for low priority 

The MSRJE console always has high (H) priority. 

For a description of the // ATTR OCL statement, see the manual Procedures 
and Commands Summary. 

4. Maximum number of sessions: Specify the maximum number of logical unit 
sessions that can be active at one time with the host system defined for this 
MSRJE configuration. The number of sessions specified cannot exceed the 
number of logical units selected for MSRJE on display 14.0 during line 
member definition for this remote system. (The manual Using System/36 
Communications contains more information.) 

The default is 01, and the maximum is 46. 

5. Minimum number of sessions: Specify the minimum number of LU sessions 
that should be active with the host system defined for this MSRJE 
configuration. If the number of active sessions drops below this number, an 
END utility control statement is simulated by MSRJE. Any MSRJE functions 
then active are allowed to terminate normally. If this number of sessions 
cannot be activated when MSRJE is started, MSRJE will not start. 

The default is 01, and the maximum is 46. 

6. Display informational messages?: If you specify Y (Yes) for this prompt, all 
MSRJE informational messages are displayed on the MSRJE console. These 
messages inform the MSRJE operator of local MSRJE activities. This prompt 
does not control messages received from the remote host system. 

Once you press the Enter key, display 35.0, which allows you to define the host 
system logon/signon information, is displayed. 
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Display 35.0 MSRJE Logon Attributes 



MSRJE LOGON ATTRIBUTES 


Remote system SNAHOST1 Remote location SNALOC1 


1. Is LOGON formatted? . 

2. Should MSRJE send first LOGON? 


SNASUB1 


W1 


Y,N N 
y,N Y 


3. Enter host LOGON/SIGNON command below: 

10_: . . .20_: . . .30_: . . .40_: . . .50_; . . .60_; . . . 70 


Cmd19-Cancel 




1. Is LOGON formatted?: Use of a formatted logon causes an SNA 
INITIATE-SELF command to be sent to the host system and enables MSRJE 
to more accurately recognize logon failures. 

Specifying an N for this prompt indicates that you will enter the LOGON 
command for prompt 3. If you specify Y, prompts 4 through 6 are displayed 
after you press the Enter key. 

2. Should MSRJE send first LOGON?: This parameter is dependent on whether 
the host system is generated to require that System/3 6 send the first logon or 
whether the host system will send the first logon. 

If you specify Y, MSRJE will send the logon to the host system when the data 
link is established. If you specify N, MSRJE will wait for the host system to 
send the first logon. 

If you specify N for this prompt, you may still have to enter the logon 
information for prompt 3 (unformatted logon) or prompts 4 through 6 
(formatted logon). 

• If you specify Y here, you must enter the logon information 

• If you specify N here, then: 

— If you specified a value greater than 1 for prompt 4 on display 34.0, 
you must enter logon information. 

— If you specified 1 for prompt 4 on display 34.0, you do not have to 
specify the logon information. 


2“34 Multiple Session Remote Job Entry Guide 






The host system determines whether to receive or send the first logon as 

follows: 

• For JES2, the host system: 

— Receives the first logon if you specified A=N on a $T RMTnnn 
command entered at the host system before using MSRJE. You 
should specify Y for prompt 2 on display 35.0. 

— Sends the first logon if you specified A=Y on a $T RMTnnn 
command entered at the host system before using MSRJE. You 
should specify N for prompt 2 on display 35.0. 

Note: You can enter a $T RMTnnn command at the System!36 MSRJE 
console. It will take effect the next time you begin communicating 
with the host system. 

• For JES3, the host system: 

— Receives the first logon if you specified N for the AUTO parameter 
of the RJPWS statement on the JES3 work station definition. You 
should specify Y for prompt 2 on display 35.0. 

— Sends the first logon if you specified Y for the AUTO parameter of 
the RJPWS statement on the JES3 work station definition. You 
should specify N for prompt 2 on display 35.0. 

• For RES, the host system: 

- Receives the first logon if you specified 0 for the PLGN parameter 
on the TERMINAL macro during RTAM generation. You should 
specify Y for prompt 2 on display 35.0. 

— Sends the first logon if you specified 1 for the PLGN parameter on 
the TERMINAL macro for the RTAM generation. You should 
specify N for prompt 2 on display 35.0. 

• For VSE/POWER, the host system always receives the first LOGON 

command. You should specify Y for prompt 2 on display 35.0. 
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3. Enter host LOGON/SIGNON command below: Specify the LOGON or 
SIGNON command that is required by the host system with which this 
MSRJE configuration will be communicating. Refer to the host system work 
sheet or contact the host system personnel for the exact logon or signon 
requirements. While the host system may define a special format for the 
logon, the general format of the logon is: 

LOGON APPLID(application name)[LOGMODE(modename)] 

[DATA(any data)] 

The value for the APPLID parameter is normally specified as follows: 

• For JES2, use JES2 

• For JES3, use JES3 

• For RES, use RTAM 

• For VSE/POWER, use POWER 

The value entered for the LOGMODE parameter, if used, specifies the name 
of an entry in a table at the host system that contains the operating 
jparameters for SNA communications. You should obtain the name of the 
LOGMODE entry from the host system work sheet or from the host system 
personnel. The table that contains the entry specified is selected by the 
MODETAB parameter of the PU macro during NCP/VTAM generation at 
the host system. The table itself is defined using the MODEENT macro. 

The value entered for the DATA parameter is based on the type of host 
system, as follows. 

. JES2 

DATA(RMTnnn [,password1] [,password2]) 

The RMTimn parameter specifies the terminal number of System/36 as 
specified in the RMTnnn parameter of the host system’s remote terminal 
description. 

passwordl parameter is optional and, if specified, is 1 through 8 
alphameric characters and must match the password specified for the 
PASSWORD subparameter of the LINEnim parameter during the 
definition of a remote work station for JES2 at the host system. 

The passwordl parameter is optional and, if used, is 1 through 8 
alphameric characters and must match the value specified for the 
PASSWORD parameter of the RMTimn parameter during remote work 
station definition for JES2 at the host system. 
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JES3 


DATA(wsname , password) 

The wsname parameter must match the value specified for the N 
parameter in the RJPWS statement during JES3 generation at the host 
system. 

The password parameter must match the value specified for the P 
parameter in the RJPWS statement at the host system. 

. RES 

)ATA('userid[ /password]TERM(termid)[PROC(procname) ] 


Tnotices 1 

Tmail 1 

\NONOTICESj 

^NOMAILJ 


S7909009-0 

The userid parameter identifies System/36 to the host system, and must 
match the value specified at the host system for the ADD subcommand of 
the ACCOUNT command. 

The password parameter is optional and, if used, must be 1 through 8 
alphameric characters and must be separated from the userid parameter by 
a slash (/). In addition, the value must match the entry made in the ADD 
subcommand for the specified user ID. 

The TERM(termid) or T(termid) parameter specifies the terminal 
identification number and must match the value entered for the TERMID 
parameter for System/36 in the TERMINAL macro for the RTAM 
generation at the host system. 

The PROC(procname) parameter allows you to specify a catalogued 
procedure (procname) at the host system that is to be executed as a part of 
the logon process. 

The NOTICES parameter, the default, allows you to specify that all 
general notices from the host system are to be listed automatically after 
logon. NONOTICES inhibits the listing of notices. 

The MAIL parameter, the default, allows you to specify that all messages 
directed to your terminal be automatically listed after logon. NOMAIL 
inhibits the listing of messages. 
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VSE/POWER 

DATA{*remid[,password][,user information]') 


The remid parameter identifies the remote ID assigned to System/3 6 
during VSE/POWER generation at the host system. It must match the 
value specified for the REMOTE parameter in the PRMT statement 
during VSE/POWER generation. 

The password parameter, if used, is 1 through 8 alphameric characters and 
must match the value specified for the PSWRD parameter of the PRMT 
statement. 

The user information, if used, can be up to 16 bytes of data. Ask the host 
system personnel whether this information is needed. 

Note: The host system may have specified a different logon format than those given 
here. Contact host system personnel to determine the correct format of the 
logon. 

Because the example is for communicating with RES, the value entered is: 

LOGON APPLID(RTAM) LOGMODE(S36MSRJE) DATA('A0 T{5) PROC(FSPROC)') 
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If you specified Y for prompt 1, display 35.0 is updated to include three more 
prompts. 




35.0 


MSRJE LOGON ATTRIBUTES 


Remote system SNAHOST1 Remote location SNALOC1 


1. Is LOGON formatted? ..... 

2. Should MSRJE send first LOGON? 


Y,N 



Y,N Y 


4. Application ID 

5. Mode name . . 

6. Data 


Cmd19-Cancel 



4. Application ID: Normally specified as follows: 

• For JES2, use JES2 

• For JES3, use JES3 

• For RES, use RTAM 

. For VSE/POWER, use POWER 

You should refer to the host system work sheet or contact the host system 
personnel to verify the entry you should make here. 

5. Mode Name: The value entered for this prompt, if used, specifies the name of 
an entry in a table at the host system that contains the operating parameters 
for SNA communications. The table that contains the entry specified is 
specified by the MODETAB parameter of the PU macro during NCP/VTAM 
generation at the host system. The table itself is generated using the 
MODEENT macro. 

6. Data: Allows you to specify up to 60 characters of data that is to be 
submitted with the logon. 

See the description of the DATA parameter in prompt 3 for a description of 
the valid entries. 

After you press the Enter key, you define the MSRJE environment by completing 
the information on the next two displays. 
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Display 36.0 MSRJE Printer/Punch Attributes 


r 36.0 MSRJE PRINTER/PUNCH ATTRIBUTES 

Remote system SNAHOST1 Remote location SNALOC1 


SNASUB1 



1. Forms control table name . 

2. Forms set.0-8 0 

3. Maximum number of printers.0-15 01 

4. Printer file sequence number. 1-99 01 

5. Maximum number of punches.0-15 01 

6. Punch file sequence number. 1-99 01 

7. Keep host data sets together.Y,N Y 


Cmdl9-Cancel 



The entries on display 36.0 define the printers and punches used for MSRJE. 

1. Forms control table name: Specify the name of the forms control table that is 
to be used with this MSRJE configuration to control the handling of print and 
punch data streams received from the host system. The forms control table is 
created by the MSRJE forms control table utility (see Chapter 5 for 
information on the forms control table utility). 

If you do not specify a name for this prompt, MSRJE handles print and punch 
data streams as described in the “Print Default Entry” and “Punch Default 
Entry” sections of Chapter 5. 

2. Forms set: Define the use of the internally maintained forms set table. The 
table contains entries for all print and punch devices supported by MSRJE. 
Use of the table allows MSRJE to remember the forms mounted for each 
device from LOGOFF of one session to LOGON of another session. This is 
useful if the host system views System/36 as the type of device that keeps the 
same form mounted all the time. 

Valid entries are 0 through 8; 0 is the default. If 0 is specified, MSRJE will 
not maintain a forms set table for this location and, therefore, will not 
maintain the forms names between sessions. Because the table can contain 
the definitions of forms for up to eight separate host systems, the value 
entered here defines which set you want used when this configuration is 
active. 

If the same forms set (other than 0) is specified in different MSRJE 
configurations, unexpected results may occur. 

Note: Initially, the forms name for all devices of all forms sets is all blanks. 

If the host system is generated to use Peripheral Data Information Records 
(PDIRs), specify 0 because the host system will always send forms names. 
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3. Maximum number of printers: Specify the maximum number of printer tasks 
that can be active. Enter a value from 0 through 15; the default is 01. This 
value should be at least as large as the number of printers specified at the host 
system for this MSRJE configuration. 

The value for the number of printers is specified at the host system as 
follows: 

• JES2, specified in the NUMPR subparameter of the RMTnnn parameter 
on the JES2 work station definition 

• JES3, specified in the PR subparameter of the RJPWS parameter on the 
JES3 work station definition 

• RES, specified in the PTRS parameter of the TERMINAL macro for the 
RTAM stage 1 generation 

• VSE/POWER, 0 through 3, depending on whether you expect print 
output 

If the host system work sheet has been filled out, refer to it for the correct 
value. If you are configuring MSRJE before the host system is generated, 
enter the Maximum number of printers on the work sheet. 

4. Printer file sequence number: Specify a number from 01 through 99 to define 
the beginning sequence number for print files written to disk. See Chapter 3 
for a description of print output, and see Chapter 5 for a description of the 
forms control table entries that control print data written to disk. 

5. Maximum number of punches: Specify the maximum number of punch tasks 
that can be active. Enter a value from 0 through 15; the default is 01. This 
value must be at least as large as the number of punches specified at the host 
system for this MSRJE configuration. 

The value for the number of punches is specified at the host system as 
follows: 

• JES2, specified in the NUMPU subparameter of the RMTnnn parameter 
on the JES2 work station definition 

• JES3, specified in the PU subparameter of the RJPWS work station 
definition parameter 

• RES, specified in the PCHS parameter of the TERMINAL macro for the 
RTAM stage 1 generation 

• VSE/POWER, always 0 or 1, depending on whether you expect punch 
output 

If the host system work sheet has been filled out, refer to it for the correct 
value. If you are configuring MSRJE before the host system is generated, 
enter the Maximum number of punches on the work sheet. 
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Punch file sequence number: Specify a number from 01 through 99 to define 
the beginning sequence number for punch files written to disk. See Chapter 3 
for a description of punch output, and see Chapter 5 for a description of the 
forms control table entries that control punch data written to disk. 

7. Keep host data sets together: Specify Y to have MSRJE attempt to write eaph 
print or punch data set of a job to the same spool file ox disk file. However, if 
a received data set has a different forms name or number of copies than the 
previously received data set of the job, MSRJE will begin a new spool file or 
disk file. 

Specify N to have each print or punch data set of a job received by MSRJE 
written to a new spool file or disk file. 

Some hosts send a peripheral data set information record (PDIR) before 
every data set. Other hosts send PDIRs only if the following data set has 
setup changes. Hosts which fully support PDIRs (send one for each data set) 
are: 


• JES2 

• JES3 if PDIR=ALL is specified on the device statement for the SNA 
work station definition. 

If your host does not fully support PDIRs, specifying yes or no for this 
prompt may have no effect. The results may be unpredictable. 

Once you press the Enter key, the last display, display 37.0, is presented. 


ff \ 

'v y 
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Display 37.0 MSRJE Reader Attributes 


37.0 MSRJE READER ATTRIBUTES SNASUBI 

Remote system SNAHOST1 Remote location SNALOC1 

1. Maximum number of MSRJE readers . 1-32 01 

2. Maximum number of host readers.1-15 01 

3. Transparency?.Y,N N 


4. 

Specify 

default 

value 

for 

TYPE. 

. P,D,S 

P 

5. 

Specify 

default 

value 

for 

CMD. 

.Y,N 

Y 

6. 

Specify 

default 

value 

for 

DEL. 

.Y,N 

N 


Cmdl9-Cancel 



Display 37.0 allows you to define the readers used by MSRJE and defined at the 
host system. 

1. Maximum number of MSRJE readers: Specify the number, from 1 through 
32, of readers that can be active at one time for this MSRJE configuration. 
The default is 1. 

By specifying a value that is greater than the value specified for the Maximum 
number of host readers prompt, you can start MSRJE readers and then allow 
them to wait for a host reader to become available. 

The number of readers that you specify here depends on your RJE 
environment. For example, if several users will be signing on to MSRJE and 
sending data files to the host subsystem, you would want to specify as many 
readers as you expect users to be signed on at one time. If all the host readers 
(prompt 2, Maximum number of host readers) are in use, MSRJE will hold 
additional reader requests and start a reader when a host reader becomes 
available. The user does not have to wait and then re-enter a request to start 
a reader. 
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Maximum number of host readers: Specify the maximum number of readers 
that can be sending data to the host system at one time. The value entered 
can be from 1 through 15; the default is 01. This value should not exceed the 
number of readers specified for the host during host system configuration. 

The maximum number of readers is specified at the host subsystems as 
follows: 




• JES2, specified in the NUMRD subparameter of the RMTnnn parameter 
on the JES2 work station definition 

• JES3, specified in the RD subparameter of the RJPWS statement for the 
JES3 work station definition 

• RES, specified in the RDRS parameter of the TERMINAL macro for the 
RTAM stage 1 generation 

• VSE/POWER, always 1 

Transparency?: Specify whether text transparency can be used with this 
MSRJE configuration. N, the default, specifies that text transparency cannot 
be used. Y specifies that text transparency can be used. 

Transparency is normally used if you will be sending and receiving data that 
contains data characters which could be handled as SNA Character String 
(SCS) control characters. Normally, this occurs in object modules or binary 
data streams. 

Specify default value for TYPE: Specify the default value to be used for the 
TYPE parameter on the MSRJE procedure or in READFILE utility control 
statements entered when this configuration is active. Specifying a value here 
is useful if most MSRJE procedure statements or READFILE utility control 
statements you use will have the same TYPE parameter value. Refer to 
“Starting an MSRJE Session” in Chapter 3 or “READFILE Utility Control 
Statement” in Chapter 4 for a complete description. 


Valid entries are: 


• P for a procedure member 

• D for a disk file 

• S for a source member 


, f 

[r j 
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5. Specify default value for CMD: Specify the default value to be used for the 
CMD parameter on the MSRJE procedure or in READFILE utility control 
statements entered when this configuration is active. Y indicates that the file 
contains utility control statements; N indicates that the file does not contain 
utility control statements. 

Specifying a value here is useful if most MSRJE procedure statements or 
READFILE utility control statements you use will have the same CMD 
parameter value. Refer to “Starting an MSRJE Session” in Chapter 3 or 
“READFILE Utility Control Statement” in Chapter 4 for a complete 
description. 

6. Specify default value for DEL: Specify the default value to be used for the 
DEL parameter on the MSRJE procedure or in READFILE utility control 
statements entered when this configuration is active. Y specifies that deleted 
records in the file are to be transmitted to the host system. N specifies that 
deleted records in the file are not to be transmitted to the host system. 

Specifying a value here is useful if most MSRJE procedure statements or 
READFILE utility control statements you use will have the same DEL 
parameter value. Refer to “Starting an MSRJE Session” in Chapter 3 or 
“READFILE Utility Control Statement” in Chapter 4 for a complete 
description. 

Once you have completed display 37.0, display 29.0 is again displayed, and you can 
then define another MSRJE configuration. To end the definition of MSRJE 
configurations, press command key 7. Display 1.0 is then presented, and you can 
either define another line or subsystem member, or end the CNFIGICF procedure 
by pressing command key 7. 
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Chapter 3. Running an MSRJE Session 


Enabling a Location for MSRJE 

Before you can run an MSRJE session, you must enable the desired MSRJE 
configuration. You defined the MSRJE configuration using the CNFIGICF 
procedure, as described in Chapter 2. A configuration consists of the subsystem 
member and the line member referenced in the subsystem member. To activate an 
MSRJE configuration, enter the ENABLE procedure command from any 
command-capable display station. MSRJE may also be started from the job queue 
or may be evoked by the EVOKE OCL statement from the command line or from 
a procedure. The ENABLE procedure uses the information in the specified 
subsystem member, and its associated tine member, to load and initialize the proper 
communications support (BSC or SNA) and to allocate the needed areas in storage. 
Once the ENABLE procedure has been run for an MSRJE configuration, MSRJE 
sessions can be started that use that configuration. 

The format of the ENABLE procedure is: 


ENABLE subsystem configuration name. 

library name 

f 

line number 


current library 




NOSHOW 

/ 

SHOW 



location name 


S9020113-0 


name: Specify the name of the MSRJE subsystem member that is to be enabled. 
You assigned this name on display 1.0 during the MSRJE subsystem 
configuration process. This parameter is required. 

For the examples in Chapter 2, the subsystem member name would be 
BSCSUBl for the BSC MSRJE example, or SNASUBl for the SNA MSRJE 
example. 


Chapters. Running an MSRJE Session 3-1 




library name: Specify the name of the library in which the configuration member 
specified for the name parameter is stored. If no entry is made, the current 
library is assumed. 

For both the BSC and SNA MSRJE examples in Chapter 2, the library is 
RJELIB. 

line number: Specify the communications line to be used by this configuration. 
Note that if the line definition within the line member does not match the 
physical characteristics of the line, a message is displayed giving you the 
option of canceling the enable request or using the line definition within the 
line member. This parameter is required. 

SHOW/NOSHOW: Specify whether you want to view the values set for the 
configuration. SHOW specifies that you do want to see the values. 
NOSHOW specifies that you do not want to see the values. 

location: Specify the name of the remote location that is to be enabled. This name 
must have been specified as a remote location name on display 30.0 during 
MSRJE subsystem configuration. 

If you specify a remote location in the ENABLE procedure command, only that 
location is enabled. If no location is specified, all locations for which Activate at 
ENABLE is specified (defined on display 30.0 during subsystem member 
configuration) are enabled. 

If N was specified for the prompt Activate location at ENABLE on display 30.0 
during subsystem member configuration, the ENABLE procedure command used 
for the BSC example shown in Chapter 2, would be: 

ENABLE BSCSUB1,RJELIBBSCLOC1 

If Y was specified for the prompt Activate location at ENABLE on display 30.0 
during subsystem member configuration, the ENABLE procedure command used 
for the SNA example in Chapter 2 would be: 

ENABLE SNASUB1,RJELIB,2 
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Starting an MSRJE Session 


You can start (sign on to) an MSRJE session from any command-capable display 
station by entering the MSRJE procedure command. You can sign on to MSRJE 
and specify that a library member or disk file be automatically read once the data 
link is established; you can sign on as the MSRJE console, or you can sign on to 
MSRJE as a reader. In addition, you can sign on to MSRJE and immediately 
release the display station, which allows MSRJE to receive output from the host 
system. 

MSRJE can also be run without a display station or an RJE operator. MSRJE may 
be started from the JOBQ or from an SSP-ICF session or evoked by using the 
EVOKE OCL statement from the command line or from a procedure. 

The format of the procedure command for signing on and specifying a library 
member to be automatically read is: 


MSRJE 

location name, 

member name 

! 

library 

current 

name 

library 

t 

PROC 

(P) 

SOURCE 








(S) 


COMMAND 

DATA 

1 

DELETE 

NODEL 


NOREL 

RELEASE 

CONSOLE 





S9020164-0 


The format of the procedure command for signing on and specifying a disk file to 
be automatically read is: 


MSRJE 

location name, 

file name 


mmddyy 

/ 

DISK 





ddmmyy 


(D) 




yymmdd 

j 


- 


COMMAND 


DELETE 

t 

NOREL 

DATA 


NODEL 


RELEASE 





CONSOLE 







S9020163-0 
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If you want to sign on to MSRJE as the MSRJE console and not specify a file or 
member to be read, simply enter: 

MSRJE location,,,,,^CONSOLE 

If you want to sign a display station on to MSRJE and do not want it to be the 
console, enter: 

MSRJE location 

The first parameter lets you specify the host subsystem (remote location) with 
which you want to communicate. 

location: Specify the name of the remote location with which you want to 

communicate using this MSRJE session. You must have assigned this name 
during MSRJE configuration on display 30.0, and the specified remote 
location must have been previously enabled. If the named remote location 
has not been both configured and enabled, a message is displayed, and the 
session will not be started. 

The next five parameters allow you to specify a disk file or library member that is 
to be automatically read when the MSRJE session is started. The file or member 
can contain a host job stream and/or MSRJE utility control statements. 

read-file-name: Specify the name of the disk file or library member that is to be 
read by an MSRJE reader once the session is started. If no value is specified, 
MSRJE assumes that input, if any, will come from the keyboard. 

library-name: Specify the name of the library that is to be searched for the member 
specified by the read-file-name parameter. If a library name is entered, only 
that library is searched for the member specified in the read-file-name 
parameter. If no library-name is entered and a library member was specified 
for the read-fUe-name parameter, the current library is searched for the 
member and, if the member is not found, the system library is searched. 

If the member cannot be found, a message is presented and you must enter 
the MSRJE procedure command again using the correct read-file-name and 
correct library-name values. 

This parameter applies only if parameter 4 is PROC, P, SOURCE, or S, or if 
parameter 4 is not specified and prompt 4 on display 37.0 (Specify default 
value for TYPE) was specified as P or S. 

date: Specify the creation date of the disk file specified for the read-file-name 
parameter that is to be read by MSRJE. If no date is specified, the named 
file with the latest creation date is read. The format of the date entry must be 
the same as the format of the system date. 

This parameter applies only if parameter 4 is DISK or D, or if parameter 4 is 
not specified and prompt 4 on display 37.0 (Specify default value for TYPE) 
was specified as D. 
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PROC or P: Specify that the read-file-name parameter is a procedure member. If 
no entry is made for this parameter, the default value specified for prompt 4, 
Specify default value for TYPE, on display 37.0 during configuration of the 
subsystem member is used. 

SOURCE or S: Specify that the read-file-name parameter is a source member. If 
no entry is made for this parameter, the default value specified for prompt 4, 
Specify default value for TYPE, on display 37.0 during configuration of the 
subsystem member is used. 

DISK or D: Specify that the read-fUe-name parameter is a disk file. If no entry is 
made for this parameter, the default value specified for prompt 4, Specify 
default value for TYPE, on display 37.0 during configuration of the subsystem 
member is used. 

COMMAND: Specify that the read-file-name disk file or member contains MSRJE 
utility control statements that are to be processed by MSRJE. 

If COMMAND is specified and transparency was selected during MSRJE 
configuration (prompt 3, Transparency? on display 37.0 during subsystem 
member configuration) for the location, unpredictable results may occur. If 
you are going to use transparency with a file or member specified as 
COMMAND, you should be certain that there are no data streams within the 
file or member that match the binary representation of the characters .. 
(period period blank). If that sequence appears at the beginning of a record 
in a file or member specified as COMMAND, MSRJE attempts to process 
that record as a utility control statement. 

If no entry is made for this parameter, the default value specified for prompt 
5, Specify default value for CMD, on display 37.0 during configuration of the 
subsystem member is used. 

If COMMAND is specified, or if it is not specified and prompt 5 on display 
37.0 is specified as Y (Y indicates command; N indicates data), all records 
within the file or member must be 80 characters long. 

DATA: Specify that the file or member specified by the read-fUe-name parameter 
contains only data and JCL to be sent to the host system. If any MSRJE 
utility control statements are in a file or member specified as DATA, they are 
sent to the host system without being processed by MSRJE. 

If no entry is made for this parameter, the default value specified for prompt 
5, Specify default value for CMD, on display 37.0 during configuration of the 
subsystem member is used. 
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DELETE: Specify that records marked as being deleted in direct or sequential files 
will be sent to the host system. 

This parameter applies only if the file is delete-capable and if parameter 4 is 
DISK or D, or if parameter 4 is not specified and prompt 4 on display 37.0 
(Specify default value for TYPE) was specified as D. 

If no entry is made for this parameter, the default value specified for prompt 
6, Specify default value for DEL on display 37.0 during configuration of the 
subsystem member is used (Y indicates delete-capable, N indicates not 
delete-capable). 

NODEL: Specify that records marked as deleted in direct and sequential files are 
not to be sent to the host system. 

This parameter applies only if the file is delete-capable and if parameter 4 is 
DISK or D, or if parameter 4 is not specified and prompt 4 on display 37.0 
(Specify default value for TYPE) was specified as D. 

If no entry is made for this parameter, the default value specified for prompt 
6, Specify default value for DEL on display 37.0 during configuration of the 
subsystem member is used (Y indicates delete-capable, N indicates not 
delete-capable). 

The following parameter allows you to designate the display station as the MSRJE 
console, or to release the display station from MSRJE once the session is started. 

I If MSRJE is being run from the JOBQ or is being evoked by using an EVOKE 

I OCL statement, the following parameter is ignored, and the display station will not 

I be used by MSRJE. 

RELEASE: Specify that the display station entering the MSRJE procedure is to be 
released (returned to System/36 as command-capable) after MSRJE has 
started. 

Specifying 

MSRJE location,,,,,^RELEASE 

provides you with a means of starting MSRJE without a reader or the MSRJE 
console so that print or punch data can be received from the host system. 

NOREL: Specify that the display station entering the MSRJE procedure is to 
remain attached to MSRJE. This is the default value. 
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CONSOLE: Specify that the display station entering the MSRJE procedure will be 
the MSRJE console. If no other display station is signed on to MSRJE as the 
console, this display station becomes the console. If another display station is 
currently signed on as the console, then a message is displayed, and the 
program ends. 

If you are using the MSRJE procedure within another procedure, you should 
consider how this last parameter affects when the MSRJE procedure ends. The 
MSRJE procedure ends: 

• If you specify RELEASE, when MSRJE starts 

• If you specify NOREL, when the reader terminates 

• If you specify CONSOLE, when the session with the host ends or when you 
release the console 

Once you have entered the MSRJE procedure command, the following display is 
presented if you signed on as the MSRJE console (by specifying the CONSOLE 
parameter in the MSRJE procedure command). 
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Once the startup has been completed, the MSRJE Console Input display is i 
presented. If you signed on to MSRJE as the MSRJE console and specified a 
read-fUe-name value, then the Readfile in Progress display is presented once the 
startup has been completed. If MSRJE cannot be started or if there is an error in 
the MSRJE procedure command, a message is presented. 

If you signed on as a reader (that is, you did not specify CONSOLE in the MSRJE 
procedure command), the following display is presented: 



If the startup is successful, the Reader Input display is presented if you signed on to 
MSRJE without specifying a read-fUe-name and without specifying CONSOLE. If 
you specified a read-fUe-name on the MSRJE procedure command, the Readfile in 
Progress display is presented. If the RELEASE parameter was specified on the 
MSRJE procedure command, the display station becomes command-capable. If an 
error occurs or if the session cannot be started, a message is displayed. 

If you press command key 19 while the Startup in Progress display is present, the 
display station is released, and the System/36 command display is presented. If the 
connection with the host system has not been completed when you press command 
key 19, the connection will not be made. If the connection has been established 
and a read-fUe-name parameter was specified on the MSRJE procedure command, 
that file or member is not read by MSRJE, and the display station is released. 
Command key 19 always terminates MSRJE. You can also press the Help key 
while the Startup in Progress display is present. 
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Input to an MSRJE Session 


Input to MSRJE is of two types: console input and reader input. 

Console input allows you to act as a host system operator; that is, you can enter 
host system commands to display and control the jobs submitted through MSRJE. 
You can also enter MSRJE utility control statements, which are processed by 
MSRJE. See “Console Input” later in this chapter for more information. 

Reader input is the means by which you can send jobs to the host system. MSRJE 
sends job statements, either from a display station keyboard as you enter records or 
from a disk file or member that you have specified. MSRJE utility control 
statements can also be entered as reader input. See “Reader Input” later in this 
chapter for more information. 


Console Input 


You can enter console input only from the display station you signed on as the 
MSRJE console. You do that by specifying the CONSOLE parameter in the 
MSRJE procedure. If no other station is signed on as the console, your display 
station becomes the MSRJE console. 

Console input is allowed only when the MSRJE Console Input display is present. 
The Console Input display appears as follows: 



The space between the two dashed lines on the Console Input display is used to 
display messages received from the host system and messages generated by 
MSRJE. You cannot enter data into that area. All console input is logged to the 
history file. Records consisting of all blanks are ignored when the Console Input 
display is present. To indicate the end of a record, press the Enter key after you 
have typed the record. 


Chapter 3. Running an MSRJE Session 3-9 





Console input is entered on lines 22 and 23 of the display, and each record entered 
can be up to 120 characters (a record ends when you press the Enter key). 

Console input can be MSRJE utility control statements or host system commands. 
The MSRJE utility control statements that can be entered are: 

. READFILE 

• LIBRARY 

• SETFORM 

• CANCEL 

• END 

See Chapter 4 for a description of the utility control statements. 

Entering a READFILE UtUity Control Statement as Console Input 

If a READFILE utility control statement is entered as console input, the keyboard 
is locked (the Input Inhibited light is on) and you cannot enter data. If the 
READFILE statement is correct and a reader can be acquired, the keyboard is 
unlocked. You can then enter console input, change to reader mode, or release the 
console. When the reader begins sending data, the message ’RDxx Started’ is 
displayed in the message area. If MSRJE is waiting for a host reader to become 
available, no message is displayed until the reader actually sends data. If the reader 
needed could not be acquired or if the READFILE statement is in error, the 
appropriate message is displayed, and the keyboard unlocked. 

Once a reader is started from the console by the READFILE utility control 
statement, it is no longer associated with the console. When the reader completes 
processing, a message is displayed at the console indicating that the reader has 
ended. 
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Command Keys from the MSRJE Console 


When the Console Input display is present, the following command keys are 
available: 

• Command key 7 causes the System/36 command display to be presented 

• Command key 19 causes the System/36 command display to be presented 

• Command key 1 requests that a reader be started for the console (the Reader 
Input display is presented) 

The Help, Print, ATTN, and Dup keys can also be used while the Console Input 
display is present. 


Using the Dup Key 


You can use the Dup key to copy the last line of data you enter. 

You need only press the Dup key once to make a line (80 characters) of copied 
characters appear, but you must press it a second time to make an additional 40 
copied characters appear on the second input line. When you have the desired 
number of characters, press the Enter key to restore the data you last entered, 
whether it was 80 or 120 characters. Make any necessary changes. Then press the 
Enter key to process the data. Any data you enter is saved, unless you enter all 
blanks. 

If you press the Dup key followed by the Help key, the Help display appears. 

When you exit Help, the copied characters appear once again. If you press the Dup 
key followed by command key 1, the copied characters remain on the display. 

MSRJE can store up to 120 characters each time you press the Enter key if you 
enter the data as console input. MSRJE can store up to 80 characters if you enter 
the data as reader input. 

Note: You can enter more than 80 characters as console input, press command key 1 
to get the Reader Input display, and then enter reader input. However, when 
you try to recall your last line of console input from the Console Input display, 
the 80 characters of reader input appears along with 40 blank characters. You 
get the last data you entered, whether it was reader or console input. 
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Reader Input 


An MSRJE reader starts when you enter the MSRJE procedure command from a 
display station without specifying CONSOLE or when a read-fUe-name is specified 
on the procedure command. You can also activate a reader from the MSRJE 
console by pressing command key 1. 

If no MSRJE reader is available (the number specified by the Maximum number of 
MSRJE readers prompt on display 37.0 during subsystem configuration has been 
exceeded), a message is displayed telling you that a reader cannot be started. If the 
request for a reader was made from a display station other than the MSRJE 
console, the program ends, and the display station is released. If the request for a 
reader was made from the MSRJE console, you can return to the MSRJE Console 
Input display by selecting option 0 in response to the message. 

If no active session is available (the Maximum number of sessions value specified on 
display 34.0 during configuration of a subsystem for SNA MSRJE has been 
exceeded) or if no host reader is available (the value specified for the Maximum 
number of host readers prompt on display 37.0 during subsystem configuration has 
been exceeded), a message is displayed telling you that all sessions or host readers 
are in use. 

If MSRJE determines that there are no host readers available (a negative response 
from the SNA host system for all configured host readers; no response within 
60-seconds from a BSC host system for all configured host readers), a message is 
sent to the console (if active) to inform you that a START command may need to 
be sent to the host system. You should select option 0 in response to the message, 
and then send the command(s) to start the host readers. 

If you select option 1 in response to the displayed message that tells you all 
sessions or host readers are in use, MSRJE will keep yoUr request for a reader 
active and wait for one to become available. The following display is presented: 
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If you choose any other option in response to the displayed message, MSRJE takes 
one of the following actions: 

• Option 0 (only if you requested a reader from the MSRJE console): Return to 
the Console Input display. The request for a reader is terminated. 

• Option 2: Return to the System/36 command display. The requesi for a 
reader is terminated. 

While the Waiting for a reader display is present, the following comniand keys are 

valid: 

• Command key 1 return to console input, if your display station is the MSRJE 

console. 


• Command key 7 return to the System/36 command display. If you specified a 
read-file-name on either the MSRJE procedure command or on a READFfLE 
utility control statement, MSRJE sends that file when a reader becomes 
available, 

* Command key 19 return to the System/36 command display. The request for 
a reader is terminated, and no data is sent. 

The Help, ATTN, and Print keys can also be used while this display is present, 

A reader terminates at a display station when you enter an EOF utility control 
statement, or when an EOF utility control statement is processed in a file or 
member that you specified as containing MSRJE utility control statements (iisirig 
the COMMAND parameter on the MSRJE procedure command or by specifying 
CMD-Y on a READFILE utility control statement). 

If you terminate the reader at a display station, the MSRJE session is terminated, 
and you can enter commands at the display station. If you terminate a reader at 
the MSRJE console, the Console Input display appears. 
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Display Station Input to a Reader 


The MSRJE Reader Input display is presented if an MSRJE reader, an LU session 
(SNA MSRJE only), and a host reader are available when you press command key 
1 at the MSRJE console or when you enter an MSRJE procedure command 
without specifying a read-file-name , CONSOLE, or RELEASE. The Reader Input 
display appears as follows: 



The space between the dashed lines on the display is used as a display area for 
reader messages. Input to a reader can only be entered on line 22 of the display. 

You can enter data, JCL statements, and certain utility control statements 
(READFILE, SETFORM, LIBRARY, EOF, and END) to MSRJE from the 
display station. The records you enter can be up to 80 characters in length. End 
each record by pressing the Enter key. Utility control statements entered are 
logged to the history file. 

If your display station is the MSRJE console, pressing command key 1 returns you 
to the MSRJE Console Input display with the message Reader Active displayed. 

Pressing command key 7 while the Reader Input display is present returns the 
display station to the System/3 6 command display. 

Pressing command key 19 while the Reader Input display is present returns the 
display station to the System/36 command display. 

The Help, Print, ATTN, and Dup keys can also be used. 
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Using the Dup Key 


You can use the Dup key to copy the last line of data you enter. 

Simply press the Dup key, then the Enter key to make your last line of data appear 
in the input area. Make any necessary changes. Then press the Enter key a second 
time to process the data. Any data you enter is saved, unless you enter all blanks. 

If you press the Dup key followed by the Help key, the Help display appears. 

When you exit Help, the copied characters appear once again. If you press the Dup 
key followed by command key 1, the copied characters remain on the display. 

Note: If you enter data as console input, you can press command key 1 to get the 
Reader Input display. If you press the Dup key and then the Enter key, the 
first 80 characters of your console input appears. You always get the last input 
you entered, whether it was reader or console input. 


Disk Input to a Reader 


You request disk input to an MSRJE reader by specifying the read-file-name 
parameter on the MSRJE procedure command when you start MSRJE or by using 
the READFILE utility control statement. When the disk is to be used for input, 
you can specify: 

• The name of the file or library member to be read 

• Whether the file or library member contains MSRJE utility control statements 

• Whether the input is from a disk file, procedure member, or source member 

• The creation date of a disk file 

• The name of the library to be searched for a procedure or source member 

• Whether deleted records are to be transmitted to the host system from a direct 
or sequential disk file 

Note: All disk files are read sequentially. Therefore, the same data is sent to the 

host system whether you specify the name of a parent file or of an alternative 
index file as the read-file-name. 

For a more complete description of disk specifications, see “READFILE Utility 
Control Statement” in Chapter 4, or see “Starting an MSRJE Session” earlier in 
this chapter for a discussion of the MSRJE procedure command. 
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If you enter a READFILE utility control statement from the display station or 
specify the read-fUe-name parameter on the MSRJE procedure control statement, 
the reader begins processing the file or member specified. You cannot enter data 
until the reader completes processing the file or member. While the reader is 
processing the file or member, the following display is presented: 



The area between the dashed lines is to display reader or console messages or to 

display messages generated by MSRJE or the host system. The only keys 

permitted are: 

• The ATTN key (to suspend the reader). 

• If your display station is the MSRJE console, pressing command key 1 returns 
you to the Console Input display with the message Reader Active displayed. 

• Command key 7, which causes the System/3 6 command display to be 
presented (the reader continues reading the file or member). 

• Command key 19, which terminates the reader and causes the System/36 
command display to be presented. 

• Help and Print keys. 
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Once processing of the file has completed, a message is displayed at the display 
station indicating that processing of the file has completed and that the reader is 
available for input from the display station. 


Files or library members used as input to MSRJE can contain only data to be sent 
to the host system, or they can contain data for the host system and utility control 
statements. (The utility control statements are processed by MSRJE and not sent 
to the host system.) The data sent to the host system can be JCL and data. The 
utility control statements that can be in a file are READFILE, SETFORM, 
LIBRARY, END, and EOF. If the file you specify as input to MSRJE contains 
utility control statements, you must define it as such to MSRJE by specifying one 
of the following: 

• COMMAND on the MSRJE procedure command (only if you specify a 
read-file-name on the command). 

• CMD-Y on the READFILE utility control statement. 

• Y for the Specify default for CMD prompt on display 37.0 during subsystem 
configuration and then not specifying either the CMD parameter on a 
READFILE utility control statement or the MSRJE COMMAND parameter 
on the MSRJE procedure command. 

All records sent to the host system by an MSRJE reader are sent as 80-character 
records, regardless of the actual length of the records within the file or member. 
For example, a file containing four 60-character records is sent to the host system 
as three 80-character records. A file containing four 120-character records is sent 
to the host system as six 80-character records. If necessary, the application 
program that is to process the data at the host system must return the received 
records to their original length. Note, however, that files or members specified as 
containing utility control statements must have a record length of 80 characters. 


Output from MSRJE 

Output from an MSRJE session can consist of one, all, or any combination of the 
following: 

• Print data from the host system 

• Punch data from the host system 

• Operator messages from the host system 

• Operator messages generated by MSRJE 

Note: You cannot use OCL statements to produce MSRJE output. 


Chapter 3. Running an MSRJE Session 3 "-17 



Print Data from the Host System 


When print data is received from the host system, MSRJE can do any of the 
following: 

• Write the print data to a System/36 printer. 

• Print up to 198 positions when you are using a forms control table with a 
CPI=15 or a print wheel ID, which has a CPI=15. 

• Write the print data to the System/36 spool file. 

• Create a new sequential file and write the print data to the file as 
256-character unprocessed records. 

• Add the print data to an existing sequential file of 256-character unprocessed 
records (this file can contain both print and punch data). 

• Create and write print data to decompressed disk files with or without carriage 
information. 

The destination of print output received from the host system is controlled by a 
forms control table. When you configured MSRJE for the location specified in the 
MSRJE procedure command, you may have specified the name of a forms control 
table that is to control print output received from the host system. The forms 
control table name is specified on display 36.0 during MSRJE subsystem 
configuration. You can create forms control tables by using the RJTABLE 
procedure command, as described in Chapter 5. If you do not create any forms 
control tables, IBM-supplied default values for print output will be used. These 
default values are supplied with MSRJE and are shown in Appendix D. 

While MSRJE is being initialized (after the MSRJE procedure has been entered), a 
check is made to determine whether the forms control table specified (on display 
36.0 during subsystem member configuration) is usable. If the table cannot be 
found or is not usable, a message is displayed giving you the option of terminating 
MSRJE or of continuing and using the IBM-supplied default values for print 
output. 

When print output is received from the host system, it is usually preceded by a host 
forms name. When MSRJE receives that host forms name, it searches the specified 
forms control table, if any, for an entry with the same name. If a matching entry is 
found, the information in that table entry is used to control forms and print 
operations, or to control creating and writing of disk files. If no matching entry is 
found, the default print output entry in the specified table is used. If no host forms 
name is received with the data, MSRJE uses the name from the previous output. If 
no forms control table was specified on display 36.0 during configuration, the 
IBM-supplied print output default values are used. The forms control table and the 
forms control table utility are described in Chapter 5. The IBM-supplied default 
values are shown in Appendix D. 
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If print output is written to the System/36 spool file, the spool file PRINTER name 
will be one of the following: 

• The host job name, if one is sent by the host subsystem and the name is 
nonblank 

• The host forms name, if one is sent by the host subsystem and the name is 
nonblank 

• The local forms name, if nonblank 
. MSRJE 

Print output written to disk is written to a compressed file (a file with 
256-character unprocessed records—unprocessed records are written exactly as 
they are received or sent to a decompressed disk file with or without carriage 
information). The RJFILE procedure command can be used to print these files. 

Print output written to a disk file is labeled by MSRJE using the print file sequence 
number (as defined on display 36.0 during MSRJE configuration) and the file label 
from the matching forms control table entry. If there is no matching entry in the 
forms control table, the print default entry is used. If there is no forms control 
table, the IBM-supplied print default values are used. The format of the label 
created by MSRJE is: 

xxxxxxnn 

where 

xxxxxx is the file label from the control table entry or MSRJE 

nn is the printer file sequence number if ADD-NO is specified in the 

control table. 

or 

nn is 00 when ADD-YES is specified in the control table entry. 

Note: ADD-YES specifies that the received print data is to be written to an existing 
file (the new data is written after any data already in the file). If ADD-YES 
is specified and a file named xxxxxxOO does not exist, MSRJE creates that 
file and then writes the received print data to it. ADD-NO specifies that the 
data is to be written to a new file that is created when needed by MSRJE. 
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Whenever a file is created using the print file sequence number, the number is 
increased by 1 for all files except the first file created. For example, if you had 
specified 10 for the print file sequence number on display 36.0 during 
configuration, the first file would be xxxxxxlO, and the next file would be 
xxxxxxl1. 

The maximum value for the sequence number is 99. If the last file created were 
xxxxxx99, the next file created would be xxxxxxOl. 

To take full advantage of the forms control table functions, you should note the 
following: 

• For SNA MSRJE, the host system should send Peripheral Data Information 
Records (PDIR) and forms names should be specified in the JCL. The sending 
of PDIRs by the host system is specified at the host during system generation. 

• For BSC MSRJE, the host system should send forms mount messages, and 
forms name should be specified in the JCL. 

If forms mount messages or PDIRs are not sent by the host system, MSRJE uses 
the last forms name received by the printer or the forms name that was saved in the 
forms set member for the printer. 

Punch Data from the Host System 

When punch data is received from the host system, MSRJE can do any of the 
following: 

• Create a new disk file and write the punch data to it. 

• Add the punch data to an existing file. 

• Create a new sequential file and write the punch data to disk as 256-character 
unprocessed records. 

• Add the punch data to an existing sequential file of 256-character unprocessed 
records (this file can contain both print and punch data). 

The destination of punch output received from the host subsystem is controlled by 
a forms control table. When you configured MSRJE for the location specified in 
the MSRJE procedure command, you may have specified the name of a forms 
control table that is to control output received from the host system. The forms 
control table name is specified on display 36.0 during MSRJE subsystem 
configuration. You can create forms control tables by using the RJTABLE 
procedure command, as described in Chapter 5. If you do not specify a forms 
control name during subsystem member configuration (on display 36.0), the 
IBM-supplied default values for punch output are used. These default values are 
shown in Appendix D. 
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When punch output is received from the host system, it is usually preceded by a 
host forms name. If MSRJE receives that name, it searches the specified forms 
control table, if any, for an entry with the same name. If a matching entry is found, 
the information in that table entry is used to control creating and writing of disk 
files. If no matching entry is found, the default punch output entry in the specified 
table is used. If no host forms name is received with the data, MSRJE uses the 
name from the previous output. If no forms control table was specified on display 
36.0 during configuration, MSRJE uses the IBM-supplied punch output default 
values. The forms control table and the forms control table utility are described in 
Chapter 5. The IBM-supplied default values are shown in Appendix D. 

Punch output directed to a disk file or to a compressed disk file is labeled by 
MSRJE using the punch file sequence number (as defined on display 36.0 during 
MSRJE configuration) and the file label from the matching forms control table 
entry. If there is no matching entry in the table, the punch default entry is used. If 
there is no forms control table, the IBM-supplied defaults for punch data, as shown 
in Appendix D, are used. The format of the label created by MSRJE is: 

xxxxxxnn 

where 

xxxxxx is the file label from the control table entry or MSRJE 

nn is the punch file sequence number if ADD-NO is specified in the 

control table. 

or 

nn is 00 when ADD-YES is specified in the control table entry. 

Note: ADD-YES specifies that received punch data is to be written to an existing file 
(the new data is written after any data already in the file). If ADD-YES is 
specified and file xxxxxxOO does not exist, MSRJE creates that file and then 
writes the punch data to it. ADD-NO specifies that the data is to be written to 
a new file that is created when needed by MSRJE. 

Whenever a file is created using the punch file sequence number, the number is 
increased by 1 for all files except the first file created. For example, if you had 
specified 10 for the punch file sequence number on display 36.0 during 
configuration, the first file would be xxxxxx 10, and the next file would be 
xxxxxxl1. 

The maximum value for the sequence number is 99. If the last file created were 
xxxxxx99, the next file would be xxxxxxOl. 
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To take full advantage of the forms control table functions, you should be aware of 
the following: 

• For SNA MSRJE, the host system should send Peripheral Data Information 
Records (PDIR), and forms names should be specified in the host system JCL. 
The sending of PDIRs by the host is specified at the host system during system 
generation. 

• For BSC MSRJE, the host system should send forms mount messages, and 
forms name should be specified in the host system JCL. 

If forms mount messages or PDIRs are not sent by the host system, MSRJE uses 
the last forms name received by the punch, or the forms name that was saved in the 
forms set member for the punch. 


Operator Messages from the Host System 

Operator messages from the host system received by MSRJE are written to the 
history file. If the MSRJE console is active when a message is received from the 
host system, the message is also displayed at the console. 

Operator Messages from MSRJE 

Messages to the operator from MSRJE are handled as follows: 

• All messages are logged to the history file. 

• Reader messages are displayed at the display station that started the reader, 
unless the display station has been released, MSRJE has been started from the 
JOBQ, or MSRJE has been evoked. 

• Readers started from the MSRJE console while in console input mode display 
only those messages that indicate the reader has started or ended. 

• Messages from MSRJE relating to console input are displayed at the MSRJE 
console. 

• Printer and punch messages are displayed at the MSRJE console if the console 
is active. 

MSRJE supports the System/36 // NOHALT capability. If a halt message is 
directed to a display station, it is automatically responded to, but not displayed, if 
the system NOHALT criteria are met. The System Reference manual describes the 
NOHALT capability. 

If a halt message is directed to a display station that has been released from 
MSRJE, the message is logged to the history file, and the default response is always 
taken. 

You can modify the default responses for MSRJE messages in the same manner as 
you can modify the default responses for other system messages. MSRJE messages 
are stored in the system message member (##MSG1). The System Reference 
manual contains more information. 
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Ending an MSRJE Session 


You can end (sign off) MSRJE at your display station and yet leave the MSRJE 
connection with the host system intact. To end MSRJE for your display station, 
use one of the following methods: 

• Press command key 7 to release the display station from MSRJE. If the 
Readfile in Progress display is present, MSRJE continues to process that file. 

If the Waiting for a reader display is present when you press command key 7, 
the display station is released, but MSRJE continues to wait for a reader to 
become available if you have entered a READFILE utility control statement or 
specified a read-file-name on the MSRJE procedure command. 

• Press command key 19 to release the display station from MSRJE and to 
immediately end the processing of any reader input for your display station. 

• Specify option 2 for any reader or console message; this option has the same 
effect as pressing command key 19. Note that specifying option 2 for a print 
or punch message has no effect on the display station. 

• A CANCEL utility control statement entered from the MSRJE console that 
specifies the reader active at your display station has the same effect as 
pressing command key 19 unless your display station is signed on as the 
MSRJE console. 

• A system operator cancel command that references the job active for your 
display station has the same effect as pressing command key 19. 

• Enter an EOF utility control statement when the Reader Input display is 
present. 

None of the preceding methods has any effect on the MSRJE connection with the 
host system. 

If you are running MSRJE using BSC and if MSRJE determines that the link 
should be dropped, a message appears at the MSRJE console or at the system 
console. This message occurs when the disconnect sequence is not received from 
the host within one minute after MSRJE sends a logoff or when MSRJE waits one 
minute to get a reader to send logoff and no logoff is available. Message 
RJE-4626 alerts you to the error condition. 
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Ending the MSRJE Connection with the Host System 


The connection with the host system is normally terminated when an END utility 
control statement is processed. After an END statement has been entered, no new 
readers can be started. Once all readers, printers, and punches have completed 
processing, if a delay value has been specified, MSRJE waits the specified length of 
time. If the time elapses, normal shutdown begins. If a printer or punch is started 
before the time elapses, MSRJE remains active. Once the printer or punch has 
completed processing, MSRJE will again begin waiting for the specified length of 
time. If the DELAY value specified on the END utility control statement is 0 or if 
no delay value has been specified, MSRJE begins shutdown as soon as all readers, 
printers, and punches have completed. The connection can also be ended by any 
of the following: 

® Specify a termination delay value (on display 34.0 during subsystem member 
configuration). This value is similar to the delay value on an END utility 
control statement, except that it does not take effect until all readers, printers, 
and punches are inactive, and the MSRJE console has been released. 

« Enter a DISABLE procedure command that specifies the active MSRJE 

subsystem. DISABLE can be entered from a command line or from the JOBQ, 
or evoked by using an EVOKE OCL statement. 

« Stop or restart the communications line at the host system (BSC only). 

« Vary inactive the line, physical unit, or logical units at the host system (SNA 

only). 
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Disabling an MSRJE Remote Location 


The subsystem used by MSRJE is terminated when you enter a DISABLE 
procedure that specifies the subsystem configuration member name. The format of 
the DISABLE procedure is: 


DISABLE 


subsystem configuration name, 


location name 


S9020109-0 


subsystem-configuration-name: Specify the name of the MSRJE subsystem that is 
to be terminated. This is the same value specified for the ENABLE 
procedure when the subsystem was activated. 

In the SNA example in Chapter 2, the name would be SNASUBl; for the 
BSC example, it would be BSCSUBl. 

location name: Specify the name of the remote location that is to be disabled. The 
name specified here should correspond to the location specified on the 
MSRJE procedure command. If no remote location name is specified, all 
enabled locations in the specified subsystem-configuration are disabled. 

To disable the remote location for the BSC example in Chapter 2, the 
procedure command would be: 

DISABLE BSCSUB1,BSCLOC1 

To disable all enabled remote locations in BSCSUBl, the format would be: 
DISABLE BSCSUBl 

For the SNA example, the format of the procedure command is: 

DISABLE SNASUBl,JES2L0C 
or 

DISABLE SNASUBl 

If MSRJE is logged on to the host system when the DISABLE procedure command 
is entered, a message is displayed indicating that there are active sessions. The 
message allows you to pend the DISABLE (option 0), retry the DISABLE (option 
1), force an immediate DISABLE (option 2), or cancel the DISABLE procedure 
(option 3). 

If the DISABLE pend option (option 0) is selected, any active MSRJE sessions 
continue processing until they are completed, but no new readers can be started. 
Any printers or punches needed to process data from the host system will be 
started, and the MSRJE console can be started. Once MSRJE has logged off from 
the host system, the DISABLE procedure is completed normally. 
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If the DISABLE retry option is selected (option 1), the DISABLE procedure is 
re-submitted. 

If the DISABLE immediate option (option 2) is selected, all MSRJE sessions active 
for the remote location are abnormally ended and termination of the link with the 
host system is attempted. 

If the DISABLE cancel option (option 3) is selected, the DISABLE procedure is 
not processed. 


MSRJE Unattended Mode of Operation 

MSRJE can run without an operator present. This is referred to as unattended 
operation. Transmitting data over a switched line after 5:00 p.m. is usually less 
expensive (based on line charges) because the discount rates are in effect. Using 
System/3 6 to collect data during the normal working hours and sending the data to 
the host system for processing after the end of the working day can be 
accomplished with System/36 MSRJE. 

Unattended mode of operation for MSRJE is handled in two areas: message 
handling and automatic termination. 

Message Handling for MSRJE Unattended Operation 

MSRJE uses the System/36 //NOHALT support to provide automatic responses 
to MSRJE-generated messages at all times. The NOHALT level of each user who 
signs on to MSRJE is used as the NOHALT level for user messages. In addition, if 
MSRJE attempts to display a message at a display station that has been released, 
the default responses are assumed regardless of the NOHALT level. 

Automatic Termination of MSRJE during Unattended Operation 

The value specified for the Termination delay in minutes prompt on display 34.0 
during the configuration process is used to set a time limit for termination of 
MSRJE. When all readers, printers, and punches have completed processing and 
the MSRJE console has been released, MSRJE waits the length of time specified by 
the Termination delay in minutes value. If the time period elapses, MSRJE begins 
normal termination. However, if a reader, printer, or punch is started or if the 
MSRJE console is started, the wait is canceled. If no delay value has been 
specified, MSRJE does not automatically terminate. 

The END utility control statement overrides the delay value specified on display 
34.0 during MSRJE configuration. 
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Getting the Status of MSRJE 


While MSRJE is running, you can get the current status by entering STATUS 
MSRJE or D M on the command line of a display station (see the example at the 
end of this section), or by selecting option 5 from the Display Communications 
Status (COMMSTAT) menu. The following illustrates the status display 
presented: 



Q MSRJE Console: Defines the display station that is currently signed on as the 

MSRJE console. 

Q Location: Identifies the remote location with which MSRJE is communicating. 

Q Host: Specifies the type of host subsystem with which MSRJE is 

communicating. 

Q Status: Indicates the current status of MSRJE for the location, as follows: 

• Active. MSRJE is currently communicating with the location. 

• Starting. An operator has signed on to MSRJE for the location, but 
MSRJE is not yet logged on to the host system. 

• Ending. MSRJE is ending communications with the remote location 
because an operator has entered an END utility control statement, 
canceled MSRJE, or requested an immediate disable, or because of a link 
error. 

• Inactive. The location is enabled, but no operator has signed on to 
MSRJE for the remote location. 
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Q MSRJE Readers: The number of configured MSRJE readers for this 

location. The number of readers corresponds to the Maximum number of 
MSRJE readers specified on display 37.0 during configuration of MSRJE for 
this remote location. 

Q Host Readers: Specifies the host readers that are currently active and 
communicating with MSRJE readers. 

Q WS-ID: Specifies the display station that is associated with the reader. A 
dash (—) indicates that the display station that started the reader has been 
released. If a work station or a dash is displayed but there is no 
corresponding Host RDRS entry, the MSRJE reader is waiting for a 
connection to a host reader. 

Q Printers: Printers specified for this MSRJE configuration. The number of 
printers corresponds to the Maximum number of printers specified on display 
36.0 for this remote location. 

Qj Output: The destination of print data received for the associated printer, as 
follows: 

• ID. The ID of a System/36 printer. 

• CDISK. A compressed file (a disk file with 256-character unprocessed 
records). 

• **. For BSC MSRJE, specifies that processing for the printer is 
suspended. A CANCEL utility control statement may need to be entered 
to free the printer. 

QQ Punches: Punches configured for this MSRJE location. The number of 

punches corresponds to the Maximum number of punches specified on display 
36.0 during configuration of this MSRJE location. 

QQ Output: The destination of punch data received for the associated punch, as 
follows: 

• Disk. A disk file with a user-defined format. 

• CDISK. A compressed file (a disk file with 256-character unprocessed 
records). 

• **. For BSC MSRJE, specifies that processing for the punch is 
suspended. A CANCEL utility control statement may need to be entered 
to free the punch. 
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Pressing command key 8 causes Help text for the status display to be presented. 
Pressing command key 15 causes the status display to be redisplayed with any new 
information. Pressing command key 16 causes the function to restart with a 
display of the first MSRJE remote location. Pressing the Roll Up key causes the 
next display for the current location, or the first display of the next enabled MSRJE 
location, if any, to be displayed. 

The status is a split display. The top part of the display (above the dashed line) is 
the status information. The bottom part of the display allows you to select a menu 
option (2) to start or stop a communications line, or to enter a command on the 
command line. 

If you use the command line of your display, enter: 

STATUS MSRJE,location 
or 

D M,location 
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Chapter 4. Controlling an MSRJE Session 


Utility control statements can be used to control an MSRJE session once it has 
been started. The utility control statements can be used to control the input, 
output, and termination phases of MSRJE operation. The utility control statements 
and the phases they affect are shown in the following table: 


Phase 

Statement 

Input 

READFILE 

LIBRARY 

EOF 

CANCEL 

Output 

CANCEL 

SETFORM 

INFOMSG 

Termination 

END 


Each utility control statement can also be classified as to whether it serves as 
reader input or console input and as to the devices from which it may be entered. 


Input Type 

Entered From 

Statement 

Reader input 

Display station or disk 

READFILE 

LIBRARY 

EOF 

SETFORM 

INFOMSG 

END 

Console input 

Console keyboard 

-1 

READFILE 

LIBRARY 

CANCEL 

SETFORM 

INFOMSG 

END 


Note: You can cancel MSRJE by using options 2 and 3 on the inquiry display. 
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MSRJE Utility Control Statements 


Each MSRJE utility control statement consists of a statement identifier and, for 
most utility control statements, parameters. The statement identifier is always the 
first word of the statement. The parameters supply the necessary information to 
the utility. Each parameter consists of a parameter keyword, which identifies the 
parameter, and the value to be supplied to MSRJE or, for the CANCEL utility 
control statement, just the value. 

The general format of an MSRJE utility control statement is: 

.. statement-identifier keyword-value,...keyword-value comment 
(. . s) 


Rules for Coding MSRJE Utility Control Statements 

The rules for coding MSRJE utility control statements are: 

statement-identifier: Two periods (.. ) followed by one blank must be placed 
before the statement-identifier. Blanks are not allowed within the 
statement-identifier. Certain statements can use a single letter abbreviation in 
place of the full statement-identifier. In the sections that follow, the 
abbreviation is indicated by the letter within parentheses beneath the full 
statement-identifier. 

keyword-value: Parameters can be entered in any order. A comma is required to 
separate one parameter from another (do not place any blanks between 
parameters). A parameter is identified by a keyword, which is followed by a 
hyphen (-) and the value assigned to the keyword (the CANCEL utility 
control statement does not use this format). 

comment: Comments can be included in utility control statements when parameters 
are entered. Leave one or more blanks after the last keyword-value and the 
comment. 

If you want an entire statement to be a comment, begin the statement with 
two periods, a blank, and an asterisk (.. *). 
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READFILE Utility Control Statement 


The READFILE statement tells MSRJE to begin reading data from a disk file, 
procedure member, or source member. A READFILE statement can be entered 
from either the reader input display or the console input display, or it can be read 
from a file or member on disk. 

The format of the READFILE statement is: 


.. READFILE NAME-name [,LIBR-name] 

[,DATE-date ] 

,TYPE- 

'p| 

( . . R) 



S 



1 

l^JJ 



S7909017-0 


NAME: Specifies the name of the disk file or the name of the source or procedure 
member that is to be read by the reader. 

Note: MSRJE cannot read folders. 


LIBR: For source or procedure members only, specifies the name of the library in 
which the member can be found. If a library name is specified, only that 
library is searched for the member. If a member is specified for the NAME 
parameter and no entry is made for the LIBR parameter, MSRJE searches the 
current library for the member. If the member is not found in that library, 
the system library (#LIBRARY) is searched. If LIBR-0 is specified, only the 
system library (#LIBRARY) is searched. 

If the member cannot be found, a message is displayed requesting that the 
LIBR or NAME value be corrected. 


If TYPE-D is specified or if no type is specified and D is specified for the 
Specify default value for TYPE prompt on display 37.0 during subsystem 
member configuration, specifying a value for LIBR causes a message to be 
displayed. 

DATE: Specifies the file creation date of the disk file to be read by MSRJE. If a 
date is not specified for a disk file, the named file having the latest creation 
date is read. The format of the date must be the same as the system date 
format. 


If TYPERS or TYPE-P is specified or if no type is specified and the Specify 
default value for TYPE prompt on display 37.0 was specified as P or S during 
subsystem member configuration, the DATE parameter is invalid, and its use 
causes a message to be displayed. 

TYPE: Specifies the type of file or member specified by the NAME parameter. 
TYPE-S indicates a source member; TYPE-P indicates a procedure member; 
and TYPE“D indicates a disk file. If no entry is made for the TYPE 
parameter, the default specified on display 37.0 during MSRJE configuration 
is used. 
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CMD: Specifies whether MSRJE is to process any utility control statements that 
are in the file or member. 

CMD-Y indicates that the file or member may contain MSRJE utility control 
statements and that MSRJE is to process any utility control statements found. 
All other records are transmitted to the host system as data. All records 
within the file or member must be 80 characters in length. 

When CMD-Y is specified for a file or member, MSRJE attempts to process 
any record that begins with .. (period period blank) as a utility control 
statement. If the record is not a utility control statement, the results will be 
unpredictable. 

CMD-N specifies that the file or member contains data only. If CMD-N is 
specified for a file or member containing utility control statements, the utility 
control statements are sent to the host system as data. 

The default value for the CMD parameter is the specification made for the 
Specify default value for CMD prompt on display 37.0 during MSRJE 
configuration. 

If CMD-Y is specified on a READFILE statement and Y was specified for 
the Transparency? prompt on display 37.0 during MSRJE configuration, 
unpredictable results may occur. If transparency is specified and the file is 
designated as CMD-Y, it is possible that the first three characters of a data 
record could be two periods followed by a blank (..). If this happens, 

MSRJE will attempt to process the record as a utility control statement. You 
should be certain that no files specified as containing utility control 
statements and using transparency contain records that start with 
period-period-blank unless those records are MSRJE utility control 
statements. 

DEL: Specifies whether deleted records in a file are to be sent to the host system. 
This parameter applies only when TYPE-D is specified and the disk file is a 
delete-capable sequential or direct file. 

DEL-Y specifies that all records within the file, including records marked as 
deleted, are to be sent to the host system. 

DEL-N specifies that deleted records are not to be sent to the host system. 

The default is the value specified for the Specify default value for DEL prompt 
on display 37.0 during MSRJE configuration. 
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READFILE statemenls can be nested; that is, a file or member can contain a 
READFILE statement that tells the reader to read another file or member. For 
example, file A contains a READFILE statement that references file B. When the 
statement is processed by MSRJE, reading of file A is suspended and the reader 
begins processing file B. Once the reader has completed processing file B, it 
returns to processing file A at the record immediately following the one that caused 
it to process file B. The following illustrates how nesting works with two files. 



FILE A FILEB 

S7909018-0 


To further illustrate nesting, assume you have three files: file A, file B, and file C. 
File A contains a READFILE statement that directs the reader to begin processing 
file B. File B contains a READFILE statement that directs the reader to begin 
processing file C. 

When the READFILE statement in file A is processed, the reader begins reading 
file B. When the READFILE statement in file B is processed, the reader begins 
reading file C. Once file C has been read, the reader returns to the record 
immediately following the READFILE statement in file B. Once file B has been 
processed, the reader returns to the record immediately following the READFILE 
statement in file A. The following illustrates this type of nesting. 



FILE A FILEB FILE C 

S7909019-0 

The number of READFILE statements that can be nested varies depending on the 
System/3 6 resources (such as disk space and storage) available when MSRJE is 
running. Generally, at least 16 levels of nesting are possible. 
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LIBRARY Utility Control Statement 


When a source or procedure member is specified in a READFILE statement and 
no LIBR value is specified, MSRJE searches the current library for the member. If 
the member is not found, the system library (#LIBRARY) is then searched. If a 
library is specified for the LIBR parameter on the MSRJE procedure command, 
only that library is searched for the named member. 

The LIBRARY statement allows you to specify a new current library. This library 
is used as the current library until another LIBRARY statement is processed, 
reading of the file or member is completed, or until the reader terminates. If the 
file or member is completed, the library that was active before MSRJE began 
reading that file or member becomes the current library again. If the reader 
terminates, the library that was active before the reader started is restored. 

The format of the LIBRARY statement is: 

.. LIBRARY NAME-(name) 

(.. L) (0) 

name: Specifies the name of the library that is to be searched first when a member 
is specified for a subsequent READFILE statement. 

0: Specifies that the system library (#LIBRARY) is to be used. 

The following example illustrates the use of the LIBRARY utility control statement 
and shows how library usage is changed and restored. Assume that an MSRJE 
session has been started and that the current active user library is named LIBA. 
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A READFILE statement that specifies a procedure member (TYPE-P) 
named PROCAl is processed, and no LIBR parameter value is specified. 
Therefore, LIRA is searched for PROCAl. If it is not found in LIBA, the 
system library (#LIBRARY) is searched. 

A LIBRARY statement that specifies LIBB is processed; this causes LIBB to 
become the current active user library. 

A READFILE statement that specifies a procedure member (TYPE-P) 
named PROCBl is processed. LIBB is searched for PROCBl. 

A READFILE statement is processed in PROCBl, which specifies PROCB2, 
a procedure member. No LIBR parameter is specified; therefore LIBB is 
searched. 

PROCB2 completes processing, and the reader resumes processing PROCBl 
(at the statement immediately after the READFILE). 

A LIBRARY statement is processed in PROCBl that specifies LIBC. 
Therefore, LIBC becomes the current active user library. 

READFILE statement in PROCBl is processed with a member (PROCC) 
specified (TYPE-P), but with no LIBR parameter specified. Therefore, LIBC 
is searched for the member. If PROCC is not found in LIBC, #LIBRARY is 
searched. 

Processing of PROCC completes and returns to PROCBl at the statement 
immediately after the READFILE that specified PROCC. 

Processing of PF;OCBl continues. 

An EOF statement is then processed by MSRJE. The reader terminates, and 
the user library active when the reader started is restored (LIBA). 
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EOF Utility Control Statement 


The EOF (end-of-file) utility control statement ends reader input to the host 
system and terminates the MSRJE reader. 

The EOF statement is only valid as reader input. 

The format of the EOF statement is: 

. . EOF 
(.. E) 

The EOF statement has no parameters. 

When an EOF statement is read, MSRJE sends all data read before the EOF 
statement to the host system and ends the reader. 

No more data is requested from either the member or file being read from disk or 
from the operator at the keyboard. If MSRJE is reading a member or file and does 
not find an EOF utility control statement before the end of the member or file, 
MSRJE requests input from the device from which the last READFILE utility 
control statement was read, beginning at the record immediately following the 
READFILE utility control statement. If the last READFILE was read from a 
display station that has since been released, MSRJE will simulate an EOF utility 
control statement. 
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CANCEL Utility Control Statement 


The CANCEL utility control statement can be entered only as console input. It 
allows you to cancel one of the MSRJE utility functions. The format of the 
CANCEL statement is: 


. . CANCEL 


(.. C) 


LRDn 

RDn 

PRn 

PUn 


S7909021-0 


LRDn: Causes MSRJE reader n to be cancelled. The value for n can be from 1 
through 32. 

RDn: Terminates the MSRJE reader associated with host reader n. The value for 
n can be from 1 through 15. 

PRn: Terminates the MSRJE printer associated with host printer n. The value for 
n can be from 1 through 15. 

PUn: Terminates the MSRJE punch associated with host punch n. The value for 
n can be from 1 through 15. 

To determine the number to use, you must first view the status of MSRJE using the 

STATUS MSRJE procedure command. 

When the CANCEL utility control statement is used to cancel a reader, it ends the 

reader before the EOF utility control statement or the end of data is processed. 

However, to the host system, it appears that the reader terminated normally. 

When the CANCEL utility control statement is used to cancel a printer or a punch, 

it causes the printer or punch to: 

1. Stop processing the data set it is currently receiving and discard any of the data 
set not yet processed 

2. Prepare to process the next printer or punch data stream 
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When a permanent error occurs on the device to which BSC MSRJE is writing 
print or punch data, the CANCEL statement may have to be used to recover data. 
For example, MSRJE printer PRl is processing output for job A. The host system 
is sending print data to System/36 for job A; some of the data has been received 
by System/36, and some has not yet been sent by the host system. While 
processing the print data, a permanent error occurs on the device to which MSRJE 
is writing the data. The MSRJE printer must terminate; however there is no way to 
inform the host system that no more output for job A can be accepted and that all 
the output should be saved at the host for later transmission. System/36 suspends 
all output for that device; that is no output for job A or any subsequent job can be 
received by PRl until the operator intervenes. To end the suspension, you can do 
one of the following: 

• Save the output for job A, by entering the host system commands (as console 
input) to stop the host system printer and to place the job output on the job 
queue again; or if you do not want to save the output, enter the host system 
command to cancel the host system printer. 

• Enter the MSRJE CANCEL utility control statement to cancel the MSRJE 
printer that failed. MSRJE then receives and discards all subsequent output for 
job A. Any subsequent output for that host system device is processed 
normally by MSRJE. 

The CANCEL utility control statement is not always needed. For example, assume 
that MSRJE printer PRl is receiving output for job B. The output data set has 
been received by MSRJE. However, not all of the received data has been 
processed by the MSRJE printer. A permanent error occurs on the device to which 
MSRJE is writing the data. Because MSRJE has received the entire output data 
set, it cannot suspend the output from the host system. MSRJE discards all 
received data and automatically prepares to handle the next output data set. 
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SETFORM Utility Control Statement 


The SETFORM utility control statement allows you to change the forms name for 
any configured MSRJE printer or punch. If you configured any forms set other 
than 0 (on display 34.0 during subsystem configuration) and MSRJE terminates 
without receiving a new forms name for the specified device, then the forms name 
you supply with the SETFORM utility control statement is saved in the form set 
member. 

The format of the statement is: 

. . SETFORM rPRnl -forms name[ , f PRn^ - forms name] [ , . . .] 

1 PUnJ 1 PUnJ 

(.. S) 

S7909022-0 


PRn, PUn: Specifies the host system device ID. The value specified for n can be 
from 1 through 15. PRn designates a printer; PUn designates a punch. 

forms name: Specifies the forms name to be used for the specified device. The 
entry can be from 1 to 8 characters and can consist of any characters except 
comma (,), slash (/), apostrophe (’), question mark (?), or hyphen (-). 

A forms name of all blanks can be specified by placing a comma immediately 
after the hyphen (-) following a PRn or PUn keyword, or by following the 
hyphen with a blank if the forms name is the last parameter (anything after 
the blank is ignored). For example, to specify a forms name of all blanks for 
printer PRl, either of the following could be used: 

.. SETFORM PR1-,PR2-ABC 
or 

.. SETFORM PR2-ABC,PRl- 

Each SETFORM statement can specify multiple printers and/or punches; the 
maximum statement length is 120 characters for console input and 80 characters 
for reader input. 
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INFOMSG Utility Control Statement 


The INFOMSG utility control statement indicates to MSRJE whether 
informational messages are to be displayed at the MSRJE console. 

The format of the INFOMSG utility control statement is: 

. . INFOMSG f YES\ 

I no; 

(.. I) 

S7909023-0 


YES: Specifies that informational messages are displayed at the console unless 
otherwise specified on display 34.0 during subsystem member configuration 
or by an INFOMSG utility control statement. 

NO: Specifies that most MSRJE-generated informational messages are sent only 
to the history file. This allows console messages from the host to be 
distinguished more easily and allows them to remain on the MSRJE console 
screen longer. 
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END Utility Control Statement 

The END utility control statement indicates that MSRJE should send the 
appropriate sign-off message to the host system as soon as all readers, 
printers, and punches have completed processing. No new readers can be 
started after this statement has been entered. 

The format of the END utility control statement is: 

.. END [DELAY-nn] 

The END statement cannot be abbreviated. 

DELAY: Specifies the amount of time, in minutes, that MSRJE is to wait after all 
readers, printers, and punches have terminated before sending the sign-off to 
the host system. The value specified can be from 0 to 99. If no value is 
specified, 0 is assumed. The value specified here overrides the value, if any, 
specified for prompt 2 (Termination delay in minutes) on display 34.0 during 
subsystem configuration. 

DELAY-0 specifies that MSRJE will send the sign-off command to the host 
system as soon as all readers, printers, and punches have completed 
processing. If any other value is set for the DELAY parameter, MSRJE waits 
that number of minutes after all readers, printers, and punches have 
completed before sending a host system sign-off. No new readers can then 
be started, but if printer or punch data is received from the host system 
before the time elapses, the appropriate MSRJE printer or punch is started. 
When those printers or punches complete processing, MSRJE will again wait 
the specified time before sending a host system sign-off. 

Note: Use caution when entering the END utility control statement as reader input. 
No other users will be able to start MSRJE readers after the END utility 
control statement has been processed. 
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Chapter 5. Creating and Maintaining Forms Control Tables 


You use the MSRJE control table utility (RJTABLE) to build a table that contains 
entries to define how output data streams received from the host system are to be 
handled by MSRJE. You also use RJTABLE to define how the MSRJE file utility 
(RJFILE) is to handle 256-character unprocessed record files created by MSRJE. 

Using the control table utility, you can define entries in a table to specify whether 
I print data streams are to be written to a printer, to a disk file that you define with 

1 or without carriage information, or to a file containing 256-character unprocessed 

records. You can also define whether punch data streams are to be written to a file 
you define or to a file containing 256-character unprocessed records. 

You assign a name to each entry (except the print and punch default entries) in the 
table. When a forms name is received from the host system in a data stream, the 
control table specified on display 36.0 during subsystem configuration is searched 
for a matching entry name. If a matching entry name is found in the table, the 
definitions in that entry are used to control the handling of the output. 

You can also use the utility to define a print default entry and a punch default entry 
for each control table you create. The default entries are used whenever a forms 
name is received from the host system and there is no matching entry in the table. 
Whenever you create a forms control table, these defaults are automatically 
included; to change their definition, you must update the default entries. 

Note: For those hosts which do not send forms mount messages or peripheral data set 
information records, there is no access into the forms control table except to 
the default entries. 

To ensure that MSRJE can read the file that contains the control table, you should 
authorize user ID MSRJE to have at least read access to the file that contains the 
control table. Refer to the System Security Guide for additional information on 
resource security. 

I Note: If you do not specify a date for your file and you use date differentiated files, 

I MSRJE uses the most recent file. 
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Control Table Entries for Print Data Streams 


Print data received from the host system can be written to a printer using the 
characteristics you define, to a disk file you define with or without carriage 
information, or to a sequential file containing 256-character unprocessed records. 
(Unprocessed records are contained in a compressed disk file.) 

When print data is received from the host system and the host system sends a 
forms name with the data, MSRJE searches the control table (as specified on 
display 36.0 during subsystem member configuration) for an entry with the same 
name as the received host forms name. If a matching entry is found, the definition 
for that entry is used to control the output. If no match is found, the printer 
default entry in that control table is used to control the output. If you have not 
specified a forms control table or if the table you specified cannot be read, MSRJE 
uses the IBM-supplied values to control the output. 

If print data is written to a compressed disk file, you must also define, in the same 
entry, the characteristics needed to print the compressed disk file, or you must 
define a file that is to be created with or without carriage information. You must 
use the RJFILE procedure command, as described in Chapter 6, to print a 
256-character compressed disk file. The printer characteristics definition in the 
same control table entry as that used to create the compressed disk file is used to 
control the printing of the file. 

If you are defining an entry for print data that is to be written to a printer, you 
specify: 

• What the local (System/36) form name is to be 

• Whether to use host printer balancing 

• The printer or printers to which the data is to be written 

• Whether the operator is to be given a chance to align the form (paper) in the 
printer 

• Whether the received data is to be spooled 

• Final quality printing or draft quality printing 

• Whether to issue an end of forms message 

• Whether to select a printwheel ID for the printer 

• Style-of-print option selected 

• The number of lines per inch to print 

• The number of characters per inch to print 
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• The number of lines to print on a page 

• The number of the last line to be printed on a page 

• Carriage control information 

If the data is to be spooled, you also specify: 

• Whether to retain the data in the spool file after it has been printed 

• Whether printing is to begin only after the job step ends 

• Whether all output to the printer is to be treated as a single print step (only 

used with the RJFILE utility as defined in Chapter 6) 

• The number of copies to be printed 

• The spool file priority of the job 

• How much activity you expect this spool file to have 

If you are defining an entry to write received print data to a file as 256-character 
unprocessed records, you define the characteristics of the file, such as: 

• The name of the file 

• The user ID when resource security is active on System/3 6 

• The expected size of the file 

• Whether the file can be extended beyond its expected size, and, if it can, the 
extension size to use 

• Where you would prefer the file be located 

• Whether the file is to be saved if an error occurs 

• Whether you want the data received for this entry added to an existing file 

• Whether allocated disk space not needed by the file can be released for use by 
other files 

If you specify that the output is to go to a compressed disk file (a file with 
unprocessed records), you also specify the same information that you specify when 
the data goes to a printer, or you also specify the same information that you specify 
when the data goes to a user-defined file. The printer information included with the 
compressed disk entry is used to control the printing of the file by the RJFILE 
utility, or the included user-defined file information is used to control the writing of 
the data to a user-defined file by the RJFILE utility. The RJFILE utility is 
described in Chapter 6. 
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If you are defining an entry for print data that is to be written to a user-defined 
file, you specify: 


f 

'v y 

• The name of the file. 

• The user ID when resource security is active on System/36. 

• The name of a System/36 procedure, if any, that MSRJE should start after the 
print data stream has been completely received. MSRJE passes two 
parameters, the file date (parameter 1) and the file name (parameter 2), to the 
System/36 procedure. 

ISlote: The values in these parameters are ignored if RJFILE is using this entry, 

• The name of the library in which the procedure is located. 

• The type of file (sequential, direct, or indexed) to create. 

• Whether the file is to be saved if an error occurs. 

• Whether you want the data received for this entry added to an existing file. 

• Whether allocated disk space not needed by the file can be released for use by 
other files. 

• The expected size of the file. 

• Whether the file can be extended beyond its expected size and, if it can, the 

extension size to use. ^ 

• Where you want the file located. 

• The record length for the file. 

• Whether the file is delete capable. 

If you specified that the file is to be an indexed file, you should also specify: 

• The starting position of the index key 

• The length of the key 

• Whether duplicate keys are allowed in the file 


I 
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When you want the print data stream written to a compressed disk file (a file with 
unprocessed records), you specify: 


• The name of the file 

• The user ID when resource security is active on System/36 

• The expected size of the file 

• Whether the file can be extended beyond its expected size, and, if it can, the 
extension size to use 

• Where you would prefer the file to be located 

• Whether the file is to be saved if an error occurs 

• Whether you want the data received for this entry added to an existing file 

• Whether allocated disk space not needed by the file can be released for use by 
other files 

You must also specify the same information as you specify when the data goes to a 
user-defined file. The user file information included with the compressed disk 
entry is used to control the converting of the compressed file by the RJFILE utility 
as described in Chapter 6. 

Note: MSRJE does not support creating folders. 
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Control Table Entries for Punch Output 


Punch data received from the host system can be written to a disk file (the 
characteristics of which you define), or the data can be written to a file containing 
256-character unprocessed records (compressed disk file). 

When punch data is received from the host system and the host system sends a 
forms name with the data, MSRJE searches the control table (as specified on 
display 36.0 during subsystem member configuration) for an entry with the same 
name as the received host forms name. If a matching entry is found, the definition 
for that entry is used to control the output. If no match is found, the punch default 
entry in that control table is used to control the output. If you have not specified a 
forms control table or if the table you specified cannot be read, MSRJE uses the 
IBM-supplied values to control the output. 

If the punch output is written to a file you define, that file can be processed later by 
one of your programs. If the data is written to a compressed disk file (a file with 
unprocessed records), you must also define, within the same control table entry, 
another file. You then use the RJFILE procedure command, as described in 
Chapter 6, to convert the compressed disk file to the file you defined. RJFILE uses 
the same entry in the same control table as was used to create the compressed disk 
file. 

If the punch output is to be written to a user-defined file, you define: 

• The name of the file. 

• The user ID when resource security is active on System/36. 

• The name of a System/36 procedure, if any, that MSRJE should start after the 
punch data stream has been completely received. MSRJE passes two 
parameters, the file date (parameter 1) and the file name (parameter 2), to the 
System/36 procedure. 

Note: The mines in these parameters are ignored if RJFILE is using this entry, 

• The name of the library in which the procedure is located. 

• The type of file (sequential, direct, or indexed) to create. 

• Whether the file is to be saved if an error occurs. 

• Whether you want the data received for this entry added to an existing file. 

• Whether allocated disk space not needed by the file can be released for use by 
other files. 


5-6 


Multiple Session Remote Job Entry Guide 



• The expected size of the file. 

• Whether the file can be extended beyond its expected size and, if it can, the 
extension size to use. 

• Where you want the file located. 

• The record length for the file. 

• Whether the file is delete-capable. 

If you specified that the file is to be an indexed file, you also specify: 

• The starting position of the index key 

• The length of the key 

• Whether duplicate keys are allowed in the file 

When you want the punch data stream written to a compressed disk file (a file with 
unprocessed records), you specify: 

• The name of the file 

• The user ID when resource security is active on System/36 

• The expected size of the file 

• Whether the file can be extended beyond its expected size and, if it can, the 
extension size to use 

• Whether the file is to be saved if an error occurs 

• Where you would prefer the file be located 

• Whether you want the data received for this entry added to an existing file 

• Whether allocated disk space not needed by the file can be released for use by 
other files 

You must also specify the same information as you specify when the data goes to a 
user-defined file. The user file information included with the compressed disk entry 
is used to control the converting of the compressed file by the RJFILE utility, as 
described in Chapter 6. 

Note: MSRJE does not support creating folders. 
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I Running the Control Table Utility 


I The control table utility is an interactive utility; that is when it is activated, it 

I presents a series of displays to request that you enter the needed information to 

I define an entry in the control table. 

I To start the control table utility, enter RJTABLE (the RJTABLE procedure 

1 command has no parameters) on the command line, or select option 5 (Define an 

I MSRJE control table) from the Define Communications display. The first display 

1 presented is the control table utility main menu. 

I Control Table Utility Main Menu 



I Select one of the following: Enter the number of the option you want to use. The 

I default is option 2. 

I Table name: You must specify the name of the forms control table with which you 

1 want to work. If you are creating a new table (option 1), enter the name you 

I want assigned to the table in which the table is stored. If you intend to work 

I with entries in an existing table (option 2, 3, 4, 6, or 8), enter the name of the 

I existing table. The next display, the control table utility entry menu, 

1 reappears. If you select option 5 (Remove a table), the entire table and the 

I file in which it is stored are deleted. The control table utility main menu 

I reappears. If you select option 7 (Print a table), enter the table name. 

I If you select option 9, the control table utility ends and the System/36 

1 command display reappears. 

I When the control table utility main menu reappears, pressing command key 7 

I cancels the control table utility. 



5-8 Multiple Session Remote Job Entry Guide 





If you select option 1, specify a table name, and press the Enter key, the MSRJE 
control table utility main menu is presented again. You have the option to specify a 
preferred disk location, as shown on the following display: 


MSRJE CONTROL TABLE UTILITY 


Work with control tables 


Optional- 


Select one of the following: 

1. Create a new table 

2. Update entries in an existing table 

3. Add entries to an existing table 

4. Remove entries from an existing table 

5. Remove a table 

6. Print entries from an existing table 

7. Print a table 

8. Review entries from an existing table 

9. End the control table utility 

Option . 1 

Table name.FORMFILE 

Preferred disk location . A1,A2,A3,A4,block number A1 

Cmd7-End of ;]ob Cmd2-Page back 


CORP IBM Corp. 1986 



Preferred disk location: This prompt appears only if you select option 1 (Create a 
new table). Specify either the disk on which you want the table placed, the 
block number at which the table should begin, or blanks. The table is placed 
on the: 

• First disk if you specify Al, the default 

• Second disk if you specify A2 

• Third disk if you specify A3 

• Fourth disk if you specify A4 

Al, A2, A3, and A4 are only preferred locations. If the disk you specify is 
full or does not exist, the table is placed wherever there is room. 

A block number can be any 6-digit number less than 560872. Your table is 
placed at the block location you specify only if that location is available. If it 
is not available, you receive a message stating it is not available, and you can 
specify another block location or disk. 

If you specify blanks, the table is placed on the least used disk. This helps 
maintain an even balance between disks. 

After you enter a preferred disk location, the next display, the control table 
utility entry menu, is presented. 
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I Control Table Utility Entry Menu 


The MSRJE control table utility entry menu allows you to select what you want to 
do with an entry in a control table. 

The heading of this display identifies what you are going to do with the table. The 
example shows Create a control table entry because option 1 was selected on the 
first display. If, for example, option 2 had been selected, the heading would be 
Update a control table entry. In all cases, the name of the table entered for the Table 
name prompt on the previous display is shown in the upper right corner. 

If you selected option 1 (Create), 2 (Update), 3 (Add), 4 (Remove), 6 (Print), or 8 
(Review) on the main menu, you will see the following display. 


MSRJE CONTROL TABLE UTILITY 


Create a control table entry 


Select a type of entry to work with: 

1. Print 

2. Print default 

3. Punch 

4. Punch default 

Option . 


FORMEILE 


Table entry name 


RESFORM1 


I 


Cmd3-Save table, display table menu 



Cmd7-Save table, end of job 

CORP IBM Corp. 1986 

J 


I If you selected option 5 (Remove a table) or 7 (Print a table) on the main menu, 

1 that display is shown again. 

Following are the options which you need to enter, depending on the option that 
you choose on the main menu. 
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Select a type of entry to work with: Specify the type of control table entry with 
which you are working. The valid options are: 

1. Print specifies that the entry is for print data received from the host 
system. 

2. Print default specifies that the entry is to be used when no matching entry 
name is found for the forms name received for print data from the host 
system. 

3. Punch specifies that the entry is for punch data received from the host 
system. 

4. Punch default specifies that the entry is to be used when no matching 
entry name is found for a punch data stream forms name received from 
the host system. 

Table entry name: Specify the name of the control table entry with which you are 
working (creating, updating, adding, or removing). When a forms name is 
received from the host system, it is compared to this name. If they match, 
this entry is used to control the output of that data stream. 

Notes: 

1. If you selected option 3 (Add entries to an existing table) on the main menu and if 
an entry matching the Table entry name you enter already exists in the table, a 
message is presented giving you two options: 

a. Change the Table entry name you entered. 

b. Press the Enter key, which causes the utility to change from the add mode to 
the update mode. You can then change the existing entry in the control table. 

2. If you selected option 2 (Update entries in an existing table) on the main menu 
and if the name you specify for the Table entry name prompt does not match a 
control table entry, a message is displayed and you are given two options: 

a. Change the Table entry name you entered. 

b. Press the Enter key, which causes the utility to change from the update mode 
to the add mode. You can then add the new entry to the control table. 

If you selected option 4 (Remove entries from an existing table) on the main menu, 
the entry menu is redisplayed after you have typed the Table entry name and 
pressed the Enter key. You can then remove another entry, or return to the main 
menu display by pressing command key 3. 

Pressing command key 3 while the entry menu is present saves all valid entries and 
causes the main menu to be displayed; pressing command key 7 saves the forms 
control table file and ends the utility. 

After you enter the type of entry you want to work with and the entry name, the 
control table output menu is displayed. 


Chapters. Creating and Maintaining Forms Control Tables 5-11 




MSRJE CONTROL TABLE UTILITY 


FORMEILE 
RESFORM1 


Create a control cable entry 




Select where the output is to go: 

1. Printer 

2. Disk file 

3. Disk file with carriage information 

4. Compressed disk file for a printer 

5. Compressed disk file for a disk file 

6. Compressed disk file for a disk file with carriage information 

Option . 1 


Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

COPR IBM Copr. 1986 

V_ _ J 


Select where the output is to go: Specify where the output associated with this 

entry is to be written. 

1. Printer specifies that print data received is to be written to the printer. 
Valid only if the entry type is print or print default. 

2. Disk file specifies that punch or print data received is to be written to a 
disk file. 

3. Disk file with carriage information specifies that print data received is to 
be written to a sequential disk file with 4 bytes of carriage information at 
the front of each record in the file. This is valid only if the entry type is 
print or print default. 

Note: The 4 carriage control bytes at the beginning of each record are 

divided into two groups. The first 2 bytes are before operations, and 
the last 2 bytes are after operations. There are two types of 
operations: skips and spaces. The 4 carriage control bytes may 
contain either skip operations or space operations in any 
combinations. The values for skip and space operations are defined 
as: 

• Skip operation of hex 80 is skip to the NEXT channel (SNA only). 

• Skip operations of hex 81 through hex 8C are skip to channel 1 
through channel 12, respectively. 

• Space operations of hex 00 through hex On are space 0 through space n 
lines, respectively. 
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4. Compressed disk file for a printer specifies that print data received is to 
be written to a sequential disk file as 256-character unprocessed records. 
This file can be printed later by RJFILE. This is valid only if the entry 
type is print or print default. 

5. Compressed disk file for a disk file specifies that print or punch data 
received is to be written to a sequential disk file as 256-character 
unprocessed records. This file can later be written by RJFILE to a disk 
file that you define. 

6. Compressed disk file for a disk file with carriage information specifies 
that the print data received is to be written to a sequential disk file as 
256-character unprocessed records. This file can be printed later by 
RJFILE to a sequential disk file that you define with 4 bytes of carriage 
information at the front of each record in the file. 

Note: The 4 carriage control bytes at the beginning of each record are 

divided into two groups. The first 2 bytes are before operations, and 
the last 2 bytes are after operations. There are two types of 
operations: skips and spaces. The 4 carriage control bytes may 
contain either skip operations or space operations in any 
combinations. The values for skip and space operations are defined 
as: 

• Skip operation of hex 80 is skip to the NEXT channel (SNA only). 

• Skip operations of hex 81 through hex 8C are skip to channel 1 
through channel 12, respectively. 

• Space operations of hex 00 through hex On are space 0 through space n 
lines, respectively. 

Pressing command key 3 while the entry menu is present saves the entry and causes 
the entry menu to be displayed; pressing command key 7 saves the forms control 
table file and ends the utility. 

Pressing command key 3 while the output menu is present saves all valid entries 
and causes the main menu to be displayed; pressing command key 7 saves the 
forms control table file and ends the utility. 
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The remainder of this chapter is organized by the functions you can perform using 
the control table utility. The displays presented are dependent on the option you 
can choose on the entry menu; therefore, the chapter is organized to lead you 
through each option. The options are: 

• Create, update, review, or add a print entry for printer output 

• Create, update, review, or add a print entry for disk file output with or without 

carriage information 

• Create, update, review, or add a print entry for compressed disk output 

• Update or review a print default entry for print output 

• Update or review a print default entry for disk file output with or without 

carriage information 

• Update or review print default entry for compressed disk output 

• Create, update, review, or add a punch entry for disk output 

• Create, update, review, or add a punch entry for compressed disk output 

• Update or review a punch default entry for disk output 

• Update or review a punch default entry for compressed disk output 

The name of the file, as specified on the main menu, and the name of the control 
table entry, as specified on the entry menu, are displayed in the upper right corner 
of all the following control table utility displays. 

Note: A control table entry name is not displayed if you are working with default 
entries or if you specified blank characters for the entry name. 

Whenever any of the following displays is present, pressing command key 3 saves 
all valid entries and returns you to the entry menu; pressing command key 7 
cancels the current entry, saves the file, and ends the utility. 

Print Entry for Printer Output 

To create a print entry with output directed to the printer, select option 1 (Create a 
new table) or option 3 (Add entries to an existing table) on the main menu, then 
select option 1 (Print) on the entry menu and option 1 (Printer) on the output 
menu. If you are updating an existing entry (option 2 on the main menu), the 
current values are presented for the named entry on each of the displays. You can 
change any of those values. After you have specified Print and Table entry name on 
the entry menu and Printer on the output menu, the next displays define which and 
how many printers you wish to use and some printer characteristics for those 
printers. 
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MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table print entry 

Optional- 

Use host printer balancing . N,Y Y 


Cmd3-Save entry, display entry menu Cmd7-End of 30 b, cancel entry 

COPR IBM Corp. 1986 



Use host printer balancing: Specifies whether you want to use a host printer 
balancing function. Yes allows you to define up to three printer IDs that 
MSRJE will direct received printer data to based upon the host printer device 
name. Printer balancing is done by the host; therefore, you must have more 
than one printer defined and active on your host system. If your host system 
does not support multiple printers per location, specify the default, N (No), 
for this prompt. You also must have more than one printer defined to your 
System/36 so you can define these System/36 printers for MSRJE’s use on 
the following display. 

The following display appears when Y (Yes) is specified for using the host 
printer balancing function. 


MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table print entry 


Use host printer balancing.N,Y 

Printer ID or SYSTEM for first printer . 

Printer ID or SYSTEM for second printer . 

Printer ID or SYSTEM for third printer . 


FORMEILE 
RESF0RM1 


Optional-* 

Y * 


SYSTEM 

P 6 

P4* 


Cmd2-Page back 
Cmd3-Save entry, 


display entry menu 


Cmd7-End of Dob, cancel entry 


COPR IBM Corp. 


1986 
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Printer ID or SYSTEM for printer: Specify the ID of the printer that is to print the 
output. Up to three printer IDs can be specified; the first two are required. If 
you want to use the system printer, you may specify SYSTEM. When you 
specify printer IDs on this display, MSRJE directs print output to the printers 
as follows: 

1 ; 

\. y 


Two printers specified 

If the host printer name is: 

MSRJE will use: 



PRl 

First printer 



PR2 

Second printer 



PR3 

First printer 



PR13 

First printer 



PR14 

Second printer 



Three printers specified 

If the host printer name is: 

MSRJE will use: 



PRl 

First printer 



PR2 

Second printer 



PR3 

Third printer 



PR4 

First printer 



PR13 

First printer 



PR14 

Second printer 



PRl 5 

Third printer 



The printer characteristics that you define on the following displays are used 
by MSRJE for all the printers that you defined for this entry. 





- 
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Local forms name: Specify the forms name for the System/36 to which the 
received host forms name is to be translated. If no entry is made, no 
translation is done. 

Align the forms before printing?: Specify whether you want the operator to have an 
opportunity to align the forms on the printer before the data begins printing. 

If you specify Y (Yes), the first line of output is printed, and a message is 
issued. The operator can then align the form and select an option that causes 
the first line to print again and the same message to be displayed, or the 
operator can select an option that allows printing to continue with the second 
line of output. 

If N (No), the default, is specified, the output is printed, without allowing the 
operator to align the forms. 

Spool?: Specify whether you want output controlled by this entry to be spooled. If 
you specify N (No), printer output controlled by this entry is not spooled, but 
is printed as it is received. If you specify Y (Yes), then the output can be 
written to the System/36 spooled file instead of directly to the printer. If 
spooling is not active on System/36, this option is ignored. 

Final quality printing?: Specify the print quality you want. If final quality printing N 
(No) is specified, and the print quality switch on the printer is set to draft 
quality, the output will be printed in draft quality. Any other combination 
causes the output to be printed in final quality. 

Issue end of forms message?: Specify Y (Yes) if you want an end of forms message 
to be sent to the console. 

Select a printwheel ID for the printer?: Specify Y (Yes) if you v/ant to select a 
printwheel ID for the 5219 Printer. If you specify Y, the display that allows 
you to specify the option for the style of print that is to be put on the 5219 
Printer is shown. 
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MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table print entry 

Select the option for the desired style of print 


FORMEILE 
RESF0RM1 

Optional-* 


A 


;yle of print 

ID values 

Style of print 

ID va; 

1 . 

Rhetoric 

05 

11 . 

Light Italic 

5B 

2 . 

Courier 10 

OB 

12 . 

Modern 

9E 

3. 

Prestige Pica 

OC 

13. 

Boldface 

9F 

4. 

Artisian 10 

OD 

14. 

Essay 

AO 

5. 

Pica 

14 

15. 

Essay Italic 

A2 

6 . 

Symbol Scribe 

50 

16. 

Prestige 15 

DD 

7. 

Script 

54 

17. 

Gothic 15 

DE 

8 . 

Courier 12 

55 

18. 

Courier 15 

DF 

9. 

Prestige Elite 

56 

19. 

Symbol Diplomat 

Scribe El 

0 . 

Letter Gothic 

57 





Option . 

Cmd3-Save entry, display entry menu 


1-19 


Cmd7-End of job, cancel entry 

(c) 1985 IBM Corp. 


Select the option for the desired style of print: If you entered Y to select a 

printwheel ID for the printer, you see a display on which you can select the 
desired style of print on the 5219 printer. The default is specified through the 
CNFIGSSP procedure. The printwheel ID cannot be specified when 
characters per inch is specified on the following display. 

The next display allows you to specify the format of the printed output, such as the 
number of lines per inch and lines per page to be printed. You also define how 
carriage control characters received from the host system in a print data stream are 
to be handled by the printer. 
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MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table print entry 


Lines per inch . . . 
Characters per inch 
Lines per page . . . 


FORMEILE 
RESF0RM1 

Optional-* 


4,6,8 

10,15 

1-112 


number 

of 

the last line 

per page 



. 1-112 


* 

skips 
01 - 

for 

1 

forms: 

02 - 

0 

03 - 

0 

04 - 

0 


05 - 

6 

06 - 

0 

07 - 

0 

08 - 

0 


09 - 

0 

10 - 

0 

1 1 - 

0 

12 - 

0 



Cmd3-Save entry, display entry menu 


Cmd7-End of job, cancel entry 

(c) 1985 IBM Corp. 


Lines per inch: This prompt is valid only for the following printers: 

• 5224 Models 1 and 2 

• 5225 Modelsl,2, 3, and4 

Valid entries are 4, 6, or 8 lines per inch. If no entry is made, the current 
specification for the printer is used. 

Characters per inch: Specify whether you want the data printed at 10 or 15 
characters per inch. This prompt is valid only for the following printers: 

• 5224 Models 1 and 2 

. 5225 Modelsl,2, 3, and4 

If the entry is left blank, the current specification for the printer is used. 

Note: You cannot use this prompt if you specified a printwheel ID on the 
previous display. 

Lines per page: Specify the number of lines on each page (the form size). Valid 
entries are any decimal number from 1 to 112. If you do not enter a value, 
the current specification for the printer is used. 
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Line number of the last line per page: Specify the number of the last line to be 

printed on a page. Valid entries are any decimal number from 1 to 112, but 
the value must be equal to or greater than the specification made for the 01 
line skip, and it must be less than or equal to the value specified for Lines per 
page. 

The default is the value specified for the Lines per page prompt or, if no value 
was specified for that prompt, the current lines per page specification for the 
printer. 

Note: If you did not specify a value for the Lines per page prompt, then you 
must not enter a value here. 

Line skips for forms: Specify which line on a page you want the printer to advance 
(skip) to when the corresponding channel control character is received. Up to 
12 entries (channel control characters 01 through 12) can be made. Each 
entry identifies a line number, and it must be less than or equal to the value 
specified for the Line number of the last line per page prompt. 

A channel control character whose assigned value is 0 causes the printer to 
advance one line. 

The default value for channel control character 01 is 1; the default for all 
other channel control characters is 0. 

Channel control character 01 corresponds to the top margin of a page. If you 
specified the Line number of the last line per page prompt as 66, you could 
specify the following: 


01 

- 1 

02 

- 5 

03 - 

10 

04 

”0 

05 

- 4 

06 

- 0 

07 - 

0 

08 

-0 

09 

- 0 

10 

- 0 

11 - 

0 

12 

-66 


If channel control character 01 is received, the printer will advance to line 1 
of the next page; if channel control character 02 is received, the printer 
advances to line 5 of the current page; channel control character 03 causes an 
advance to line 10 of the current page; channel control character 05 causes 
the printer to advance to line 4 on the next page; and channel control 
character 12 advances the form to line 66, the last line. All other channel 
control characters cause the printer to advance one line. 

Notes: 

1. These values can only be specified if a value has been specified for the Lines 
per page prompt. 

2. Under SNA, a received vertical tab table overrides the specifications made 
for the previous three prompts. 

If you had specified N (No) for the Spool? prompt on the previous display, you 
have completed defining a print entry. The entry menu is redisplayed. 

If you specified Y (Yes) for the Spool? prompt, continue with the next display. 
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MSRJE CONTROL TABLE UTILITY 


FORMEILE 
RESFORM1 


Create an MSRJE forms control table print entry 


Optional-* 

Hold in the spool file after printing?.N,Y N 

Begin printing when the job step ends?.Y,N Y 

Continue printing the same job stream?.N,Y N 

Number of copies to be printed . 1-255 ♦ 

Priority on the spool file.0-5 1 

Expected activity of spooled print file . N,H,L,M N 


L Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. I 


Note: This display is only presented if you have selected spooling for the printer 
output. 

Hold in spool fUe after printing?: Specify whether you want to keep the print output 
in the spool file after it has been printed. Y (Yes) specifies that you want the 
data kept in the file after it has been printed; N (No) specifies that the print 
data can be removed from the spool file after it has printed. N (No) is the 
default. 

Begin printing when the job step ends?: Specify whether the system should wait 
until the job step has been completed before it begins printing the data or 
whether it can begin printing the data before the job step ends. Y (Yes), the 
default, specifies that the system should wait. N (No) specifies that printing 
can begin before the job step ends. 

Continue printing the same job stream?: Specifies whether you want all output to 
the device printed as a single print step. This parameter is only used with the 
RJFILE procedure (see Chapter 6). 

Number of copies to be printed: Specify the number of copies of spooled output to 
be printed for the job step. Valid entries are any decimal number from 1 to 
255 or a blank. 

If a blank is specified (this is also the default) the number of copies printed is 
dependent on the protocol. For BSC MSRJE output, 1 is assumed. For SNA 
MSRJE output, the number of copies specified in the Peripheral Data 
Information Record (PDIR) received from the host system is used. 
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Priority on the spool file: Assigns a priority, from 0 through 5, to the spooled 
output. The system prints jobs in decreasing priority order. For example, 
print output with a priority of 5 is printed before other jobs on the spool file. 
Jobs with the same priority are printed in the same order they were written to 
the spool file. Priority 0 jobs are not printed until the system operator issues 
the RELEASE command to specifically release them for printing. If no 
priority is specified, 1 is assumed. 

Expected activity of the spooled print file: Specify how much activity you expect 
this spool file to have. The system uses the activity level to allocate system 
data area to the file. Valid entries are: 

• N for normal activity (the default) 

• H for high activity 

• L for low activity 

• M for medium activity 

A file with high activity requires the most system data area space. 

You have now completed defining a print entry. 
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When creating, updating, or adding a print entry with output going to a printer, you 
will be prompted, when the printer parameters are complete, for any changes to the 
existing compressed disk file parameters. 



Compressed disk file creation information is put into each print entry. This 
information is used by MSRJE when it tries to print the data and the printer is not 
available. When the data is sent to a compressed disk file, it can be printed later by 
the RJFILE utility. 

When reviewing a print entry with output going to a printer, you can also review 
the existing compressed disk file parameters. 

You see line 0 if you are creating, updating, or adding to a print entry with output 
going to a printer. You see line 0 if you are reviewing a print entry. The 
compressed disk file information display appears at the end of all print entry input 
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I Print Entry for Disk File Output 


To create a print entry with output directed to a disk file, select option 1 (Create a 
new table) or option 3 (Add entries to an existing table) on the main menu, then 
select option 1 (Print) on the entry menu and option 2 (Disk file) on the output 
menu. If you are updating an existing entry (option 2 on the main menu), the 
current values are presented for the named entry on each of the displays. You can 
change any of those values. After you have selected print and a table entry name 
on the entry menu, and disk file on the output menu, the following displays are 
shown. 




The first display allows you to define the characteristics of the file you want 
created. You can supply such information as the file name and type of file. 


MSRJE CONTROL TABLE UTILITY FORMFILE 

RESFORM2 

Create an MSRJE forms control table print entry 

Optional-* 

Name of the file to be created.MSRJE 

User ID.MSRJE 

Procedure name. * 

Library name . #LIBRARY 

Type of file to be created.S,D,I S 

Save the file in case of error?.Y,N Y 

Add output to an existing file?.N,Y N 

Free unused file blocks?.Y,N Y 

Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 


Name of the fUe to be created: Specify the name of the file that is to be created by 
MSRJE. MSRJE is the default. The file is labeled xxxxxxnn, where xxxxxx is 
the value specified for this prompt, and nn is 00 if the data is to be added to 
an existing file, or nn is equal to the print file sequence number as specified 
on display 36.0 during MSRJE configuration. 

User ID: When resource security is active on System/36, specify the user ID that 
is to be used when print data is written to disk and when a procedure is 
started by MSRJE. The ID specified can be from 1 to 8 characters. 

I 


Library name: Specify the name of the System/36 library that contains the 
procedure specified for the previous prompt. 

Type of file to be created: Specify whether you want MSRJE to create a sequential 
file (S, the default), a direct file (D), or an indexed file (I). 


Procedure name: Specify the name of a System/36 procedure, if any, that should 
be started by MSRJE after this print data stream has been received. 
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Save the file in case of error?: Specify whether you want the data written to the file 
to be saved if an error occurs before the file is closed. Y (Yes), the default, 
specifies that if an error occurs before all data has been written to the file, the 
system will save the data already written to the file. N (No) specifies that the 
data already written will be lost if an error occurs before the file has been 
closed. 

Note: If you wish to add data to an existing file (see the next prompt), you 

should specify Y for this prompt. If you specify N and an error occurs, 
the entire file, including the data previously in the file, will be deleted. 

Add output to an existing file?: Specify whether you want the print data received 
for this entry to be added to an existing disk data file. Y (Yes) specifies that 
you want the data added to file xxxxxxOO, where xxxxxx is the value specified 
for the Name of the file to be created prompt. N (No), the default, specifies 
that you want a new file created, and that file will be named xxxxxxnn, where 
xxxxxx is the value specified for the Name of the file to be created parameter, 
and nn is the print file sequence number. 

If you specify Y and a file by the specified name cannot be found, a new file 
will be created using that name. 

Notes: 

L Only one device can use the file at one time. 

2. If you specify yes to this prompt and specified no to prompt 1, Keep host data 
sets together on the MSRJE Printer/Punch Attributes display (display 36.0), 
the yes on this prompt will override the no on display 36.0. 

Free unused file blocks?: Specify whether blocks that are not used by the file can 
be released for use by other files. Specify Y (Yes), the default, or N (No). 

Specify N (No) if the file will be located on a remote system. Unused file 
blocks cannot be released on remote systems. 

Note: All carriage information for a print entry for disk file output will be 
ignored. 
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The next display allows you to specify additional characteristics of the file, such as 
the initial allocated disk space for the file and whether the file can later be 
expanded. 


MSRJE CONTROL TABLE UTILITY FORMEILE 

RESFORM2 

Create an MSRJE forms control table print entry 

Optional-* 

Number of blocks to be reserved . 1-560872 60 

Number of blocks to extend the file. 0-560872 10 

Preferred disk location.A1 ,A2 ,A3 ,A4,block number A1 ♦ 

Record length in bytes . 1-4096 80 

Delete capable file? . N,Y N 


Cmd3-Previous menu, save entry 


Cmd7-End, cancel entry 

(c) 1983 IBM Corp. 


Number of blocks to be reserved: Specify, in decimal, the number of blocks that are 
to be initially allocated for this file. Any number from 1 to 560872 is valid, 
but the specification cannot exceed the amount of available disk storage. The 
default is 60 blocks. 

Number of blocks to extend the fUe: Specify the number of blocks by which the file 
should be enlarged if the file becomes full. If 0 is specified, the file cannot be 
extended (enlarged). Any decimal value from 0 to 560872 can be specified; 
the default is 10. 

Preferred disk location: Specify either the disk on which you want the file placed or 
the block number at which the file should begin. The file is placed on the: 

• First disk if you specify Al, the default 

• Second disk if you specify A2 

• Third disk if you specify A3 

• Fourth disk if you specify A4 

Al, A2, A3, and A4 are only preferred locations. If the disk you specify is 
full or does not exist, the file is placed wherever there is room. 

A block number can be any 6-digit number less than 560872. Your file is 
placed at the block location you specify only if that location is available. 
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Record length in bytes: Specify the size of the records that are to be written to the 
file. MSRJE uses a buffer size of 198 bytes to restructure the data into 
records the size you specify. For example, if you specify a record length of 
396, MSRJE will write two print records in each disk record. 

Delete capable file?: Specify whether the file being created is to be a 

delete-capable file. Y specifies that it is; N, the default, specifies that it is not 
delete-capable. 

If you specified a file type of S (sequential) or D (direct) for the Type of file to be 
created prompt, this completes your definition. The entry menu is displayed. If 
you specified a file type of I (indexed), you must complete one more display. 


MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table print entry 


FORMEILE 
RESFORM2 


Starting position of the key . 1-4096 1 

Length of the key.1-120 1 

Allow duplicate keys?.N,Y N 


L Cmd3-Save entry, display entry menu CmdV-End of job, cancel entry 

(c) 1983 IBM Corp. 

__ J 


Starting position of the key: Specify the first position of the key within the record, 
which can be any value from 1 through 4096. The default is 1. 

Length of the key: Specify the number of bytes in the key. Any value from 1 
through 120 is valid. The default is 1. 

l^ote: The value specified for Starting position of the key plus the value specified for 
Length of the key minus 1 must be less than or equal to the defined record 
length. 

Allow duplicate keys?: Specify whether more than one record can have the same 
key value within the file. N (No), the default, specifies that duplicate keys 
are not allowed. Y (Yes) specifies that duplicate keys are allowed. 

If N is specified, duplicate key errors may occur since the host system can 
send duplicate header or trailer records to System/36. 

This completes the definition for a print entry with output to a disk file. The entry 
menu is displayed. 


Chapter 5. Creating and Maintaining Forms Control Tables 5-27 





I Print Entry for Disk File with Carriage Information Output 

I To create a print entry with output directed to a disk file with carriage information, 

I select: 

I L Option 1 (Create a new table) or option 3 (Add entries to an existing table) on 

I the main menu 

I 2. Option 1 (Print) on the entry menu 

I 3. Option 3 (Disk file with carriage information) on the output menu 

1 If you are updating an existing entry (option 2 on the main’menu), the current 

I values are presented for the named entry on each of the displays. You can change 

I any of those values. After you have selected Print and entered a Table entry name 

I on the entry menu (the table entry name defines the entry in the table), and 

I selected Disk file with carriage information on the output menu, the next display is 

I presented. 

The first display allows you to define the characteristics of the file you want 
created. You can supply such information as the file name and type of file. 
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Name of the file to be created: Specify the first 6 characters of the name of the file 
to be created when print output is written to a compressed disk file. MSRJE 
is the default name. 

The file is named as follows: 
xxxxxxnn 

where: 

xxxxxx is the value you specify for the Name of the fUe to be created 
prompt. 

nn is the printer file sequence number (as specified on display 36.0 

during MSRJE configuration) if the Add output to an existing 
file? prompt is specified as N (No). 

or 

nn is 00 if the Add output to an existing file? prompt is Y (Yes). 

User ID: When resource security is active on System/36, specify the user ID 
that is to be used when punch data is written to disk and when a procedure 
is started by MSRJE. The ID specified can be from 1 to 8 characters. 

Procedure name: Specify the name of a System/36 procedure, if any, that 

should be started by MSRJE after this print data stream has been received. 

Library name: Specify the name of the System/36 library that contains the 
procedure specified for the previous prompt. 

Type of fUe to be created: Specify whether you want MSRJE to create a 
sequential file (S, the default), a direct file (D), or an indexed file (I). 

A sequential file (S) must be specified since option 1 (Print) or option 2 
(Print default) was selected on the type of entry menu and option 3 (Disk 
file with carriage information) was selected on the output menu. 
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Save the file in case of error?: Specify whether you want the data written to the 
file to be saved if an error occurs before the file is closed. Y (Yes), the 
default, specifies that if an error occurs before all data has been written to 
the file, the system will save the data already written to the file. N (No) 
specifies that the data already written will be lost if an error occurs before 
the file has been closed. 

Note: If you wish to add data to an existing file (see the next prompt), you 
should specify Y for this prompt. If you specify N and an error 
occurs, the entire file, including the data previously in the file, will be 
deleted. 

Add output to an existing file?: Specify whether you want the print data received 
for this entry to be added to an existing disk data file. Y (Yes) specifies 
that you want the data added to file xxxxxxOO, where xxxxxx is the value 
specified for the Name of the file to be created prompt. N (No), the 
default, specifies that you want a new file created, and that file will be 
named xxxxxxnn, where xxxxxx is the value specified for the Name of the 
file to be created parameter, and nn is the print file sequence number. 

If you specify Y and a file by the specified name cannot be found, a new 
file will be created using that name. 

Notes: 

1. Only one device can use the file at one time. 

2. If you specify yes to this prompt and specified no to prompt 7, Keep host 
data sets together on the MSRJE Printer/Punch Attributes display 
(display 36.0), the yes on this prompt will override the no on display 36.0. 

Free unused file blocks?: Specify whether blocks that are not used by the file can 
be released for use by other files. Specify Y (Yes), the default, or N (No). 

Specify N (No) if the file will be located on a remote system. Unused file 
blocks cannot be released on remote systems. 
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The next display allows you to specify additional characteristics of the file, such as 
the initial allocated disk space for the file and whether the file can later be 
expanded. 



Number of blocks to be reserved: Specify, in decimal, the number of blocks that are 
to be initially allocated for this file. Any number from 1 to 560872 is valid, 
but the specification cannot exceed the amount of available disk storage. The 
default is 60 blocks. 

Number of blocks to extend the file: Specify the number of blocks by which the file 
should be enlarged if the file becopies full. If 0 is specified, the file cannot be 
extended (enlarged). Any decimal value from 0 to 560872 can be specified; 
the default is 10. 

Preferred disk location: Specify either the disk on which you want the file placed or 
the block number at which the file should begin. The file is placed on the: 

• First disk if you specify Al, the default 

• Second disk if you specify A2 

• Third disk if you specify A3 

• Fourth disk if you specify A4 

Al, A2, A3, and A4 are only preferred locations. If the disk you specify is 
full or does not exist, the file is placed wherever there is room. 

A block number can be any 6-digit number less than 560872. Your file is 
placed at the block location you specify only if that location is available. 
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Record length in bytes: Specify the size of the records that are to be written to the 
file. 

A record length of 136 or 202 must be specified since option 1 (Print) or 
option 2 (Print default) was selected on the type of entry menu, and 
option 3 (Disk file with carriage information) was selected on the output 
menu. 

Delete capable file?: Specify whether the file being created is to be a 

delete-capable file. Y specifies that it is; N, the default, specifies that it is not 
delete-capable. 

This completes the definition for a print entry with output to a disk file with 
carriage information. The entry menu is displayed. 

Print Entry for Compressed Disk File for Printer Output 

To create a print entry with output directed to a compressed disk file for a 
printer, you select option 1 (Create a new table) or option 3 (Add entries to 
an existing table) on the main menu, then select option 1 (Print) and option 4 
(Compressed disk file for a printer) on the entry menu and on the output 
menu. If you are updating an existing entry (option 2 on the main menu), the 
current values are presented for the named entry on each of the displays. You 
can change any of those values. After you have entered print and a table 
entry name on the entry menu and compressed disk file for a printer on the 
output menu, the following display is presented. 




MSRJE CONTROL TABLE UTILITY FORMFILE 

RESFORM4 

Create an MSRJE forms control table compressed disk file entry 

Optional-* 




Name of the file to be created . . , 

User ID.. 

Number of blocks to be reserved 
Number of blocks to extend the file 

Preferred disk location . 

Save the file in case of error? 

Add output to an existing file? 

Free unused file blocks? . 

Cmd3-Save entry, display entry menu 



. MSRJE 

. MSRJE 

. 1-560872 60 

. 0-560872 10 

A1,A2,A3,A4,block number A1 * 

.Y,N Y 

.N,Y N 

.Y,N Y 

Cmd7-End of job, cancel entry 

COPR IBM Corp. 1986 

J 
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Name of the fOe to be created: Specify the first 6 characters of the name of the file 
to be created when print output is written to a compressed disk file. MSRJE 
is the default name. 

The file is named as follows: 
xxxxxxnn 

where: 

xxxxxx is the value you specify for the Name of the file to be created 
prompt. 

nn is the printer file sequence number (as specified on display 36.0 

during MSRJE configuration) if the Add output to an existing 
fUe? prompt is specified as N (No). 

or 

nn is 00 if the Add output to an existing file? prompt is Y (Yes). 

User ID: Specify the user ID to be used when output is being written to disk and 
resource security is active. The user ID can be from 1 to 8 characters; the 
default is MSRJE. 

Number of blocks to be reserved: Specify, in decimal, the number of blocks that are 
to be initially allocated for this file. Any number from 1 to 560872 is valid, 
but the specification cannot exceed the amount of available disk storage. The 
default is 60 blocks. 

Number of blocks to extend the file: Specify the number of blocks by which the file 
should be enlarged if the file becomes full. If 0 is specified, the file cannot be 
extended (enlarged). Any decimal value from 0 to 560872 can be specified; 
the default is 10. 

Preferred disk location: Specify either the disk on which you want the file placed or 
the block number at which the file should begin. The file is placed on the: 

• First disk if you specify Al, the default 

• Second disk if you specify A2 

• Third disk if you specify A3 

• Fourth disk if you specify A4 

Al, A2, A3, and A4 are only preferred locations. If the disk you specify is 
full or does not exist, the file is placed wherever there is room. 

A block number can be any 6-digit number less than 560872. Your file is 
placed at the block location you specify only if that location is available. 
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Save the file in case of error?: Specify whether you want the data written to the file 
to be saved if an error occurs before the file is closed. Y (Yes), the default, 
specifies that if an error occurs before all data has been written to the file, the 
system will save the data already written to the file. N (No) specifies that the 
data already written will be lost if an error occurs before the file has been 
closed. 

Note: If you wish to add data to an existing file (see the next prompt), you 

should specify Y for this prompt. If you specify N and an error occurs, 
the entire file, including the data previously in the file, is deleted. 

Add output to an existing file?: Specify whether you want the print data received 
for this entry to be added to an existing compressed disk file. Y (Yes) 
specifies that you want the data added to file xxxxxxOO, where xxxxxx is the 
value specified for the Name of the fUe to be created prompt. N (No), the 
default, specifies that you want a new file created, and that file will be named 
xxxxxxnn, where xxxxxx is the value specified for the Name of the file to be 
created prompt, and nn is the print file sequence number. 

If you specify Y and a file by the specified name cannot be found, a new file 
will be created using that name. 

Notes: 

1. Only one device can use the file at one time. 

2. If you specify yes to this prompt and specified no to prompt 7, Keep hast data 
sets together on the MSRJE Printer/Punch Attributes display (display 26.0), 
the yes on this prompt will override the no on display 36.0. 

Free unused file blocks?: Specify whether blocks that are not used by the file are to 
be released for use by other files. Specify Y (Yes), the default, or N (No). 

Specify N (No) if the file will be located on a remote system. Unused file 
blocks cannot be released on remote systems. 
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You have now completed defining the compressed disk file for print output that is 
to be written to disk. You must still define the print information for the entry so 
that the disk file utility can print the data. Therefore, you are led through the 
remaining displays to define print information. 


MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table print entry 


FORMFILE 

RESFORM4 

Optional-* 


Local forms name . 

Printer ID or SYSTEM ..SYSTEM 

Align the forms before printing? . N,Y N 

Spool?.Y,N Y 

Final quality printing? . N,Y N 

Issue end of forms message?.Y,N Y 

Select a printwheel ID for the printer?.N,Y N 


Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1985 IBM Corp. 



Local forms name: Specify the forms name for the System/36 to which the 
received host forms name is to be translated. If no entry is made, no 
translation is done. 

Printer ID or SYSTEM: Specify the work station ID of the printer that is to print 
this output. If you intend to use the system printer, then specify SYSTEM. 
SYSTEM is the default. 

Align the forms before printing?: Specify whether you want the operator to have an 
opportunity to align the forms on the printer before the data begins printing. 

If you specify Y (Yes), the first line of output is printed and a message is 
issued. The operator can then align the form and select an option that causes 
the first line to print again and the same message to be displayed, or the 
operator can select an option that allows printing to continue with the second 
line of output. 

If N (No), the default, is specified, the output is printed without allowing the 
operator to align the forms. 

Spool?: Specify whether you want output controlled by this entry to be spooled. If 
you specify N (No), printer output controlled by this entry is not spooled, but 
is printed as it is received. If you specify Y (Yes), then the output can be 
written to the System/36 spool file instead of directly to the printer. If 
spooling is not active on System/36, this option is ignored. 
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Final quality printing?: Specify the print quality you want. If final quality printing N 
(No) is specified, and the print quality switch on the printer is set to draft 
quality, the output will be printed in draft quality. Any other combination 
causes the output to be printed in final quality. 

Issue end of forms message?: Specify Y (Yes) if you want an end of forms message 
to be sent to the console. 

Select a printwheel ID for the printer?: Specify Y (Yes) if you want to select a 
printwheel ID for the 5219 Printer. If you specify Y, the display that allows 
you to specify the option for the style of print that is to be put on the 5219 
Printer is shown. 


MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table print entry 

Select the option for the desired style of print 


FORMEILE 
RESFORM4 

Optional-* 


style of print 

ID values 

1 . 

Rhetoric 

05 

2. 

Courier 10 

OB 

3. 

Prestige Pica 

OC 

4. 

Artisian 10 

OD 

5. 

Pica 

14 

6. 

Symbol Scribe 

50 

7. 

Script 

54 

8. 

Courier 12 

55 

9. 

Prestige Elite 

56 

10. 

Letter Gothic 

57 

Option 




Style of print 

ID values 

11. 

Light Italic 

5B 

12. 

Modern 

9E 

13. 

Boldface 

9F 

14. 

Essay 

AO 

15. 

Essay Italic 

A2 

16. 

Prestige 15 

DD 

17. 

Gothic 15 

DE 

18. 

Courier 15 

DF 

19. 

Symbol Diplomat 

Scribe El 


1-19 


Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1985 IBM Corp. 



Select the option folr the desired style of print: If you entered Y to select a 

printwheel ID for the printer, you see a display on which you can select the 
desired style of print on the 5219 Printer. The default is specified through the 
CNFIGSSP procedure. The printwheel ID cannot be specified when 
characters per inch is specified on the following display. 
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The next display allows you to specify the format of the printed output, such as the 
number of lines per inch and inches per page to be printed. You also define how 
carriage control characters received from the host system in a print data stream are 
to be handled by the printer. 



Lines per inch: This prompt is valid only for the following printers: 

• 5224 Models 1 and 2 

• 5225 Models 1, 2, 3, and 4 

Valid entries are 4, 6, or 8 lines per inch. If no entry is made, the current 
specification for the printer is used. 

Characters per inch: Specify whether you want the data printed at 10 or 15 
characters per inch. This prompt is valid only for the following printers: 

• 5224 Models 1 and 2 

. 5225 Modelsl,2, 3, and4 

If no entry is made, the current specification for the printer is used. 

Note: You cannot use this prompt if you specified a printwheel ID on the 
previous display. 

Lines per page: Specify the number of lines on each page (the size of the forms). 
Valid entries are any decimal number from 1 to 112. If you do not enter a 
value, the current specification for the printer is used. 
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Line number of the last line per page: Specify the number of the last line to be 
printed on a page. Valid entries are any decimal number from 1 to 112, but 
the value must be equal to or greater than the specification made for the 01 
Line skip, and it must be less than or equal to the value specified for Lines per 
page. 

The default is the value specified for the Lines per page prompt or, if no value 
was specified for that prompt, the current lines per page specification for the 
printer. 

Note: If you did not specify a value for the Lines per page prompt, then you 
must not enter a value here. 

Line skips for forms: Specify which line on a page you want the printer to advance 
(skip) to when the corresponding channel control character is received. Up to 
12 entries (channel control characters 01 through 12) can be made. Each 
entry identifies a line number, and it must be less than or equal to the value 
specified for the Line number of the last line per page prompt. 

A channel control character whose assigned value is 0 causes the printer to 
advance one line. 

The default value for channel control character 01 is 1; the default for all 
other channel control characters is 0. 

Channel control character 01 represents the top margin of the page. If you 
had specified 66 for the Line number of the last line per page prompt, you 
could specify the following: 


01 

- 1 

02 - 

5 

03 - 

10 

04 - 

0 

05 

~ 4 

06 - 

0 

07 - 

0 

08 - 

0 

09 

- 0 

10 - 

0 

11 - 

0 

12 - 

66 


If channel control character 01 is received, the printer will advance to line 1 
of the next page; if channel control character 02 is received, the printer 
advances to line 5 of the current page; channel control character 03 causes an 
advance to line 10 of the current page; channel control character 05 causes 
the printer to advance to line 4 on the next page; and channel control 
character 12 advances the form to line 66, the last line. All other channel 
control characters cause the printer to advance one line. 

Notes: 

1. These values can only be specified if a value has been specified for the Lines 
per page prompt. 

2. Under SNA, a received vertical tab table overrides the specifications made 
for the previous three prompts. 

If you had specified N (No) for the Spool? prompt on the previous display, you 
have completed defining a print entry. The entry menu is redisplayed. 


/' 

I 


\ 
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If you specified Y (Yes) for the Spool? prompt, continue with the next display. 




MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table print entry 


FORMEILE 
RESFORM4 

Optional-* 


Hold in the spool file after printing?.N,Y N 

Begin printing when the 30 b step ends?.Y,N Y 

Continue printing the same job stream?.N,Y N 

Number of copies to be printed . 1-255 * 

Priority on the spool file.0-5 1 

Expected activity of spooled print file . N,H,L,M N 


Cmd3-Save entry, display entry menu Cmd7-End of 30 b, cancel entry 

(c) 1983 IBM Corp. 



Note: This display is presented only if you have selected spooling for the printer 
output. 

Hold in the spool file after printing?: Specify whether you want to keep the print 
output in the spooled disk file after it has been printed. Y (Yes) specifies that 
you want the data kept in the file after it has been printed; N (No) specifies 
that the print data can be removed from the spooled file after it has printed. 

N (No) is the default. 

Begin printing when the joh step ends?: Specify whether the system should wait 
until the job step has been completed before it begins printing the data or 
whether it can begin printing the data before the job step ends. Y (Yes), the 
default, specifies that the system should wait. N (No) specifies that printing 
can begin before the job step ends. 

Continue printing the same job stream?: Specify whether you want all output to the 
device printed as a single print step. This prompt is only used with the 
RJFILE (see Chapter 6) utility. 

Number of copies to be printed: Specify the number of copies of spooled output to 
be printed for the job step. Valid entries are any decimal number from 1 to 
255 or a blank. 

If a blank is specified (this is also the default) the number of copies printed is 
dependent on the protocol. For BSC MSRJE output, 1 is assumed. For SNA 
MSRJE output, the number of copies specified in the Peripheral Data 
Information Record (PDIR) received from the host system is used. 
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Priority on the spool file: Specify a priority, from 0 through 5, for the spooled 
output. The system prints jobs in decreasing priority order. For example, 
print output with a priority of 5 is printed before other jobs on the spooled 
file. Jobs with the same priority are printed in the same order they were 
written to the spool file. Priority 0 jobs are not printed until the system 
operator issues the RELEASE command to specifically release them for 
printing. If no priority is specified, 1 is assumed. 

Expected activity of spooled print fUe: Specify how much activity you expect this 
file to have. The system uses the activity level to allocate system data area to 
the file. Valid entries are: 

• N for normal activity (the default) 

• H for high activity 

• L for low activity 

• M for medium activity 

A file with high activity requires the most system data area space. 

I You have now completed defining an entry for print output to a compressed disk 

1 file for a printer. The entry menu is displayed. 


i 

V 
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I Print Entry for Compressed Disk File for Disk File Output 

I To create a print entry with output directed to a compressed disk file for a disk file, 

I select: 

I 1. Option 1 (Create a new table) or option 3 (Add entries to an existing table) on 

I the main menu 

I 2. Option 1 (Print) on the entry menu and option 5 (Compressed disk file for a 

1 disk file) on the output menu 

1 If you are updating an existing entry (option 2 on the main menu), the current 

I values are presented for the named entry on each of the displays. You can change 

1 any of those values. After you have entered print and a table entry name on the 

I entry menu and compressed disk file for a disk file on the output menu, the 

I following displays are presented. 


MSRJE CONTROL TABLE UTILITY 

Create an MSRJE forms control table compressed disk file entry 


FORMEILE 
RESFORM5 


Name of the file to be created . . 

User ID . 

Number of blocks to be reserved 
Number of blocks to extend the file 

Preferred disk location . 

Save the file in case of error? 

Add output to an existing file? 

Free unused file blocks? . 

Cmd3-Save entry, display entry menu 



Optional-* 

MSRJE 

MSRJE 


. 1-560872 60 

. 0-560872 10 

A1,A2,A3,A4,block number A1 * 

.Y,N Y 

.N,Y N 

.Y,N Y 


Cmd7-End of ^ob, cancel entry 

COPR IBM Corp. 1986 
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Name of the file to be created: Specify the first 6 characters of the name of the file 
to be created when print output is written to a compressed disk file. MSRJE 
is the default name. 

The file is named as follows: 
xxxxxxnn 

where: 

xxxxxx is the value you specify for the Name of the file to be created 
prompt. 

nn is the print file sequence number (as specified on display 36.0 

during MSRJE configuration) if the Add output to an existing 
file? prompt is specified as N (No). 

or 

nn is 00 if the Add output to an existing file? prompt is Y (Yes). 

User ID: Specify the user ID to be used when output is being written to disk and 
resource security is active. The user ID can be from 1 to 8 characters; the 
default is MSRJE. 

Number of blocks to be reserved: Specify, in decimal, the number of blocks that are 
to be initially allocated for this file. Any number from 1 to 560872 is valid, 
but the specification cannot exceed the amount of available disk storage. The 
default is 60 blocks. 

Number of blocks to extend the fUe: Specify the number of blocks by which the file 
should be enlarged if the file becomes full. If 0 is spedfied, the file cannot be 
extended (enlarged). Any decimal value from 0 to 560872 can be specified; 
the default is 10. 

Preferred disk location: Specify either the disk on which you want the file placed or 
the block number at which the file should begin. The file is placed on the: 

• First disk if you specify Al, the default 

• Second disk if you specify A2 

• Third disk if you specify A3 

• Fourth disk if you specify A4 

Al, A2, A3, and A4 are only preferred locations. If the disk you specify is 
full or does not exist, the file is placed wherever there is room. 

A block number can be any 6-digit number less than 560872. Your file is 
placed at the block location you specify only if that location is available. 
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Save the file in case of error?: Specify whether you want the data written to the file 
to be saved if an error occurs before the file is closed. Y (Yes), the default, 
specifies that if an error occurs before all data has been written to the file, the 
system will save the data already written to the file. N (No) specifies that the 
data already written will be lost if an error occurs before the file has been 
closed. 

Note: If you wish to add data to an existing file (see the next prompt), you 

should specify Y for this prompt. If you specify N and an error occurs, 
the entire file, including the data previously in the file, is deleted. 

Add output to an existing file?: Specify whether you want the print data received 
for this entry to be added to an existing compressed disk file. Y (Yes) 
specifies that you want the data added to file xxxxxxOO, where xxxxxx is the 
value specified for the Name of the file to be created prompt. N (No), the 
default, specifies that you want a new file created, and that file will be named 
xxxxxxnn, where xxxxxx is the value specified for the Name of the file to be 
created prompt, and nn is the print file sequence number. 

If you specify Y and a file by the specified name cannot be found, a new file 
will be created using that name. 

Notes: 

1. Only one device can use the file at one time. 

2. If you specify yes to this prompt and specified no to prompt 1, Keep host data 
sets together on the MSRJE Printer/Punch Attributes display (display 36.0), 
the yes on this prompt will override the no on display 36.0. 

Free unused file blocks?: Specify whether blocks that are not used by the file are to 
be released for use by other files. Specify Y (Yes), the default, or N (No). 

Specify N (No) if the file will be located on a remote system. Unused file 
blocks cannot be released on remote systems. 

Note: All carriage information for print entry for disk file output will be ignored. 
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Once you have compieted the definition for the compressed disk file, you define 
the characteristics of a data file so that the RJFILE utility (see Chapter 6) can 
convert the compressed file to a data file usable by your program. The following 
sequence of displays is presented. 



Name of the fUe to be created: Specify the first 6 characters of the name of the file 
that is to be created by MSRJE. MSRJE is the default name. 

The file will be named as follows: 

xxxxxxnn 

where: 

xxxxxx is the value you specify for the Name of the file to be created 
prompt. 

nn is the print file sequence number (as specified on display 36.0 

during MSRJE configuration) if the Add output to an existing fUe? 
prompt is specified as N (No) 

or 

nn is 00 if the Add output to an existing file? prompt is Y (Yes). 

User ID; When resource security is active on System/36, specify the user ID that 
is to be used when print data is written to disk and when a procedure is 
started by MSRJE. The ID specified can be from 1 through 8 characters. 
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Procedure name: Specify the name of a System/36 procedure, if any, that should 
be started by MSRJE or RJFILE after this print data stream has been 
received. 

When running RJFILE, if the procedure contains a LOAD OCL statement, 
the procedure should also contain a LIBRARY OCL statement with the name 
of the library that contains the program that is to be loaded. If the procedure 
does not contain a library statement, the program that is to be loaded must be 
located in the system library. 

Library name: Specify the name of the System/36 library that contains the 
procedure specified for the previous prompt. 

Type of file to be created: Specify whether you want MSRJE to create a sequential 
file (S, the default), a direct file (D), or an indexed file (I). 

Save the file in case of error?: Specify whether you want the data written to the file 
to be saved if an error occurs before the file is closed. Y (Yes), the default, 
specifies that if an error occurs before all data has been written to the file, the 
system will save the data already written to the file. N (No) specifies that the 
data already written will be lost if an error occurs before the file has been 
closed. 

Note: If you wish to add data to an existing file (see the next prompt), you 

should specify Y for this prompt. If you specify N and an error occurs, 
the entire file, including the data previously in the file, is deleted. 

Add output to an existing file?: Specify whether you want the print data received 
for this entry to be added to an existing disk data file. Y (Yes) specifies that 
you want the data added to file xxxxxxOO, where xxxxxx is the value specified 
for the Name of the fUe to be created prompt. N (No), the default, specifies 
that you want a new file created, and that file will be named xxxxxxnn, where 
xxxxxx is the value specified for the Name of the file to be created prompt, 
and nn is the print file sequence number. 

If you specify Y and a file by the specified name cannot be found, a new file 
will be created using that name. 

Notes: 

1. Only one device can use the file at one time. 

2. If you specify yes to this prompt and specified no to prompt 7, Keep host data 
sets together on the MSRJE Printer/Punch Attributes display (display 36.0), 
the yes on this prompt will override the no on display 36.0. 

Free unused fUe blocks?: Specify whether blocks that are not used by the file can 
be released for use by other files. Specify Y (Yes), the default, or N (No). 

N (No) should be specified if the file will be located on a remote system. 
Unused file blocks cannot be released on remote systems. 
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MSRJE CONTROL TABLE UTILITY 


FORMEILE 
RESFORM5 



Number of blocks to be reserved: Specify, in decimal, the number of blocks that are 
I to be initially allocated for this file. Any number from 1 to 560872 is valid, 

I but the specification cannot exceed the amount of available disk storage. The 

default is 60 blocks. 

Number of blocks to extend the file: Specify the number of blocks by which the file 
should be enlarged if the file becomes full. If 0 is specified, the file cannot be 
1 extended (enlarged). Any decimal value from 0 to 560872 can be specified; 

1 the default is 10. 

Preferred disk location: Specify either the disk on which you want the file placed or 
the block number at which the file should begin. The file is placed on the: 

• First disk if you specify Al, the default 

• Second disk if you specify A2 

• Third disk if you specify A3 

• Fourth disk if you specify A4 

Al, A2, A3, and A4 are only preferred locations. If the disk you specify is 
full or does not exist, the file is placed wherever there is room. 

I A block number can be any 6-digit number less than 560872. Your file is 

placed at the block location you specify only if that location is available. 
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Record length in bytes: Specify the size of the records that are to be written to the 
file. RJFILE uses a buffer size of 198 bytes to restructure the data into 
records the size you specify. For example, if you specify a record length of 
396, RJFILE will write two print records in each disk record. 

Delete capable file? Specify whether the file being created is to be a delete-capable 
file. Y specifies that it is; N, the default, specifies that it is not 
delete-capable. 

If you specified a file type of S (sequential) or D (direct) for the Type of file to be 
created prompt, this completes your definition. The entry menu is displayed. If 
you specified a file type of I (indexed), you must complete one more display. 


MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table print entry 


Starting position of the key . 1-4096 

Length of the key.1-120 

Allow duplicate keys?.N,Y 


FORMFILE 

RESFORM5 


L Cmd3-Save entry, display entry menu CmdV-End of job, cancel entry 

(c) 1983 IBM Corp. 

__ _ J 


Starting position of the key: Specify the first position of the key within the record, 
which can be any value from I through 4096. The default is I. 

Length of the key: Specify the number of bytes in the key. Any value from I 
through 120 is valid. The default is I. 

}^ote: The value specified for Starting position of the key plus the value specified for 
Length of the key minus 1 must be less than or equal to the defined record 
length. 

Allow duplicate keys?: Specify whether more than one record can have the same 
key value within the file. N (No), the default, specifies that duplicate keys 
are not allowed. Y (Yes) specifies that duplicate keys are allowed. 

If N is specified, duplicate key errors may occur since the host system can 
send duplicate header or trailer records to System/36. 

This completes the definition for a print entry with output to a compressed disk file 
for a disk file. The entry menu is displayed. 
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I Print Entry for Compressed Disk FUe for a Disk File with Carriage Information Output 


I To create a print entry with output directed to a compressed disk file for a disk file 

I with carriage information, select: 

I 1. Option 1 (Create a new entry) or option 3 (Add entries to an existing table) on 

I the main menu 

I 2. Option 1 (Print) on the entry menu 

I 3. Option 6 (Compressed disk file for a disk file with carriage information) on the 

I output menu 

I If you are updating an existing entry (option 2 on the main menu), the current 

I values are presented for the named entry on each of the displays. You can change 

I any of those values. After you have entered Print and Table entry name on the 

I entry menu and compressed disk file for a disk file with carriage information on the 

I output menu, the following displays are presented. 


MSRJE CONTROL TABLE UTILITY FORMFILE * 

RESFORM6 

Create an MSRJE forms control table compressed disk file entry 

Optional-* 

Name of the file to be created.MSRJE 

User ID . ..MSRJE 

Number of blocks to be reserved .. 1-560872 60 

Number of blocks to extend the file. 0-560872 10 

Preferred disk location . A1,A2,A3,A4,block number A1 * 

Save the file in case of error?.Y,N Y 

Add output to an existing file?.N,Y N 

Free unused file blocks?.Y,N Y 

Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

COPR IBM Corp, 1986 
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Name of the ffle to be created: Specify the first 6 characters of the name of the file 
to be created when print output is written to a compressed disk file. MSRJE 
is the default name. 

The file will be named as follows: 

xxxxxxnn 

where: 

xxxxxx is the value you specify for the Name of the file to be created 
prompt. 

nn is the print file sequence number (as specified on display 36.0 

during MSRJE configuration) if the Add output to an existing 
file? prompt is specified as N (No). 

or 

nn is 00 if the Add output to an existing file? prompt is Y (Yes). 

User ID: Specify the user ID to be used when output is being written to disk and 
resource security is active. The user ID can be from 1 to 8 characters; the 
default is MSRJE. 

Number of blocks to be reserved: Specify, in decimal, the number of blocks that are 
to be initially allocated for this file. Any number from 1 to 560872 is valid, 
but the specification cannot exceed the amount of available disk storage. The 
default is 60 blocks. 

Number of blocks to extend the file: Specify the number of blocks by which the file 
should be enlarged if the file becomes full. If 0 is specified, the file cannot be 
extended (enlarged). Any decimal value from 0 to 560872 can be specified; 
the default is 10. 

Preferred disk location: Specify either the disk on which you want the file placed or 
the block number at which the file should begin. The file is placed on the: 

• First disk if you specify Al, the default 

• Second disk if you specify A2 

• Third disk if you specify A3 

• Fourth disk if you specify A4 

Al, A2, A3, and A4 are only preferred locations. If the disk you specify is 
full or does not exist, the file is placed wherever there is room. 

A block number can be any 6-digit number less than 560872. Your file is 
placed at the block location you specify only if that location is available. 
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Save the fUe in case of error?: Specify whether you want the data written to the file 
to be saved if an error occurs before the file is closed. Y (Yes), the default, 
specifies that if an error occurs before all data has been written to the file, the 
system will save the data already written to the file. N (No) specifies that the 
data already written will be lost if an error occurs before the file has been 
closed. 

Note: If you wish to add data to an existing file (see the next prompt), you 

should specify Y for this prompt. If you specify N and an error occurs, 
the entire file, including the data previously in the file, is deleted. 

I Add output to an existing file?: Specify whether you want the print data received 

I for this entry to be added to an existing compressed disk file. Y (Yes) 

specifies that you want the data added to file xxxxxxOO, where xxxxxx is the 
value specified for the Name of the file to he created prompt or MSRJE. N 
(No), the default, specifies that you want a new file created, and that file will 
be named xxxxxxnn, where xxxxxx is the value specified for the Name of the 
I file to he created prompt, and nn is the print file sequence number. 

If you specify Y and a file by the specified name cannot be found, a new file 
will be created using that name. 

I Notes: 

I 1. Only one device can use the file at one time. 

I 2. If you specify yes to this prompt and specified no to prompt 7, Keep host data 

I sets together on the MSRJE Printer/Punch Attributes display (display 36.0), 

I the yes on this prompt will override the no on display 36.0. 

Free unused file blocks?: Specify whether blocks that are not used by the file are to 
be released for use by other files. Specify Y (Yes), the default, or N (No). 

Specify N (No) if the file will be located on a remote system. Unused file 
blocks cannot be released on remote systems. 
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Once you have completed the definition for the compressed disk file, you define 
the characteristics of a data file so that the RJFILE utility (see Chapter 6) can 
convert the compressed file to a data file usable by your programs. The following 
sequence of displays is presented. 




MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table print entry 


FORMEiLE 
RESFORM6 

Optional-* 


Name of the file to be created . . 

User ID.. 

Procedure name . 

Library name . 

Type of file to be created .... 
Save the file in case of error? 

Add output to an existing file? 

Free unused file blocks? . 

Cmd3-Save entry, display entry menu 

_ 


. MSRJE 
. MSRJE 

♦ 


. . . #LIBRARY 
S,D,I S 
. Y,N Y 
. N,Y N 
. Y,N Y 


Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 



Name of the fOe to be created: Specify the first 6 characters of the name of the file 
that is to be created by MSRJE. MSRJE is the default name. 

The file will be named as follows: 

xxxxxxnn 

where: 

xxxxxx is the value you specify for the Name of the fUe to be created 
prompt. 

nn is the print file sequence number (as specified on display 36.0 

during MSRJE configuration) if the Add output to an existing fUe? 
prompt is specified as N (No) 

or 

nn is 00 if the Add output to an existing fUe? prompt is Y (Yes). 
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User ID: When resource security is active on System/36, specify the user ID that 
is to be used when punch data is written to disk and when a procedure is 
started by MSRJE. The ID specified can be from 1 through 8 characters. 

Procedure name: Specify the name of a System/36 procedure, if any, that should 
be started by MSRJE or RJFILE after this print data stream has been 
received. 

When running RJFILE, if the procedure contains a LOAD OCL statement, 
the procedure should also contain a LIBRARY OCL statement with the name 
of the library that contains the program that is to be loaded. If the procedure 
does not contain a library statement, the program that is to be loaded must be 
located in the system library. 

Library name: Specify the name of the System/36 library that contains the 
procedure specified for the previous prompt. 

Type of file to be created: Specify whether you want MSRJE to create a sequential 
file (S, the default), a direct file (D), or an indexed file (I). 

A sequential file (S) must be specified since option 1 (Print) or option 2 
(Print default) was selected on the type of entry menu and option 6 
(Compressed disk file for a disk file with carriage information) was selected 
on the output menu. 

Save the file in case of error?: Specify whether you want the data written to the file 
to be saved if an error occurs before the file is closed. Y (Yes), the default, 
specifies that if an error occurs before all data has been written to the file, the 
system will save the data already written to the file. N (No) specifies that the 
data already written will be lost if an error occurs before the file has been 
closed. 

Note: If you wish to add data to an existing file (see the next prompt), you 

should specify Y for this prompt. If you specify N and an error occurs, 
the entire file, including the data previously in the file, is deleted. 

Add output to an existing fUe?: Specify whether you want the print data received 
for this entry to be added to an existing disk data file. Y (Yes) specifies that 
you want the data added to file xxxxxxOO, where xxxxxx is the value specified 
for the Name of the fUe to be created prompt. N (No), the default, specifies 
that you want a new file created, and that file will be named xxxxxxnn, where 
xxxxxx is the value specified for the Name of the fUe to be created prompt, 
and nn is the print file sequence number. 

If you specify Y and a file by the specified name cannot be found, a new file 
will be created using that name. 

Notes: 

1. Only one device can use the file at one time. 

2. If you specify yes to this prompt and specified no to prompt 7, Keep host data 
sets together on the MSRJE Printer/Punch Attributes display (display 36.0), 
the yes on this prompt will override the no on display 36.0. 
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Free unused file blocks?: Specify whether blocks that are not used by the file can 
be released for use by other files. Specify Y (Yes), the default, or N (No). 

N (No) should be specified if the file will be located on a remote system. 
Unused file blocks cannot be released on remote systems. 



Number of blocks to be reserved: Specify, in decimal, the number of blocks that are 
to be initially allocated for this file. Any number from 1 to 560872 is valid, 
but the specification cannot exceed the amount of available disk storage. The 
default is 60 blocks. 

Number of blocks to extend the file: Specify the number of blocks by which the file 
should be enlarged if the file becomes full. If 0 is specified, the file cannot be 
extended (enlarged). Any decimal value from 0 to 560872 can be specified; 
the default is 10. 

Preferred disk location: Specify either the disk on which you want the file placed or 
the block number at which the file should begin. The file is placed on the: 

• First disk if you specify A1, the default 

• Second disk if you specify A2 

• Third disk if you specify A3 

• Fourth disk if you specify A4 

Al, A2, A3, and A4 are only preferred locations. If the disk you specify is 
full or does not exist, the file is placed wherever there is room. 

A block number can be any 6-digit number less than 560872. Your file is 
placed at the block location you specify only if that location is available. 
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Record length in bytes: Specify the size of the records that are to be written to the 
file. 

A record length of 136 or 202 must be specified since option 1 (Print) or 
option 2 (Print default) was selected on the type of entry menu, and option 6 
(Compressed disk file for a disk file with carriage information) was selected 
on the output menu. 

Delete capable file? Specify whether the file being created is to be a delete-capable 
file. Y specifies that it is; N, the default, specifies that it is not 
delete-capable. 

This completes the definition for a print entry with output to a compressed disk file 
for a disk file with carriage information. The entry menu is displayed. 


Print Default Entry 


One print default entry is defined for each control table file. This entry is used if 
there is no entry in the active control table that matches the received host forms 
name. Whenever you create a new table (option 1 on the main menu), the control 
table utility automatically inserts a print default entry in that table. Therefore, you 
cannot create or add a print default entry but can update the existing entry. When 
you enter the Table entry name or leave it blank on the entry menu, a message is 
displayed telling you that the entry exists. Press the Enter key to update the entry. 

Updating a print default entry is the same as updating a print entry with printer 
output or a print entry with compressed disk output, except that option 2 (Print 
default entry) must be specified on the entry menu. 

You can remove a print default entry that you have updated. The control table 
automatically replaces the removed entry with the original entry containing the 
values supplied by IBM. 

The default values supplied by IBM are shown in Appendix D. 
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Punch Entry for Disk File Output 


To create a punch entry with output directed to a disk file, select: 

1. Option 1 (Create a new table) or option 3 (Add entries to an existing table) on 
the mian menu 

2. Option 3 (Punch) on the entry menu 

3. Option 2 (Disk file) on the output menu. 

If you are updating an existing entry (option 2 on the main menu), the current 
values are presented for the named entry on each of the displays. You can change 
any of those values. After you have entered Punch and Table entry name on the 
entry menu and Disk file on the output menu, the following displays are presented. 

The first display allows you to define the characteristics of the file you want 
created. You can supply such information as the file name and type of file. 


MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table punch entry 


FORMFILE 

RESF0RM7 


Optional-* 


Name of the file to be created . . 

User ID . 

Procedure name . 

Library name . 

Type of file to be created .... 
Save the file in case of error? 

Add output to an existing file? 

Free unused file blocks? . 

Cmd3-Save entry, display entry menu 



MSRJE 

MSRJE 


. #LIBRARY 

. S,D,I S 

.Y,N Y 

.N,Y N 

.Y,N Y 

Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 

_ / 


Name of the file to he created: Specify the name of the file that is to be created by 
MSRJE. MSRJE is the default. The file is labeled xxxxxxnn, where xxxxxx is 
the value specified for this prompt, and nn is 00 if the data is to be added to 
an existing file, or nn is equal to the punch file sequence number as specified 
on display 36.0 during MSRJE configuration. 

User ID: When resource security is active on System/36, specify the user ID that 
is to be used when punch data is written to disk and when a procedure is 
started by MSRJE. The ID specified can be from 1 to 8 characters. 

Procedure name: Specify the name of a System/36 procedure, if any, that should 
be started by MSRJE after this punch data stream has been received. 
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Library name: Specify the name of the System/36 library that contains the 
procedure specified for the previous prompt. 

Type of file to be created: Specify whether you want MSRJE to create a sequential 
file (S, the default), a direct file (D), or an indexed file (I). 

Save the file in case of error?: Specify whether you want the data written to the file 
to be saved if an error occurs before the file is closed. Y (Yes), the default, 
specifies that if an error occurs before all data has been written to the file, the 
system will save the data already written to the file. N (No) specifies that the 
data already written will be lost if an error occurs before the file has been 
closed. 

Note: If you wish to add data to an existing file (see the next prompt), you 

should specify Y for this prompt. If you specify N and an error occurs, 
the entire file, including the data previously in the file, will be deleted. 

Add output to an existing file?: Specify whether you want the punch data received 
for this entry to be added to an existing disk data file. Y (Yes) specifies that 
you want the data added to file xxxxxxOO, where xxxxxx is the value specified 
for the Name of the file to be created prompt. N (No), the default, specifies 
that you want a new file created, and that file will be named xxxxxxnn, where 
xxxxxx is the value specified for the Name of the file to be created parameter, 
and nn is the punch file sequence number. 

If you specify Y and a file by the specified name cannot be found, a new file 
will be created using that name. 

Notes: 

1. Only one device can use the file at one time. 

2. If you specify yes to this prompt and specified no to prompt 7, Keep host data 
sets together on the MSRJE Printer/Punch Attributes display (display 36.0), 
the yes on this prompt will override the no on display 36.0. 

Free unused file blocks?: Specify whether blocks that are not used by the file can 
be released for use by other files. Specify Y (Yes), the default, or N (No). 

Specify N (No) if the file will be located on a remote system. Unused file 
blocks cannot be released on remote systems. 


1 
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The next display allows you to specify additional characteristics of the file, such as 
the initial allocated disk space for the file and whether the file can later be 
expanded. 


MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table punch entry 


Number of blocks to be reserved . . 
Number of bloclcs to extend the file 
Preferred disk location . 


1-560872 

0-560872 


FORMEILE 
RESFORM7 

Optional-* 

60 

10 


.A1,A2,A3,A4,block number A1 


Record length in bytes... 1-4096 80 

Delete capable file? . N,Y N 


Cmd3-Previous menu, save entry 



Cmd7-End, cancel entry 

COPR IBM Corp. 1986 

J 


Number of blocks to be reserved: Specify, in decimal, the number of blocks that are 
to be initially allocated for this file. Any number from 1 to 560872 is valid, 
but the specification cannot exceed the amount of available disk storage. The 
default is 60 blocks. 

Number of blocks to extend the file: Specify the number of blocks by which the file 
should be enlarged if the file becomes full. If 0 is specified, the file cannot be 
extended (enlarged). Any decimal value from 0 to 560872 can be specified; 
the default is 10. 

Preferred disk location: Specify either the disk on which you want the file placed or 
the block number at which the file should begin. The file is placed on the: 

• First disk if you specify Al, the default 

• Second disk if you specify A2 

• Third disk if you specify A3 

• Fourth disk if you specify A4 

Al, A2, A3, and A4 are only preferred locations. If the disk you specify is 
full or does not exist, the file is placed wherever there is room. 

A block number can be any 6-digit number less than 560872. Your file is 
placed at the block location you specify only if that location is available. 
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Record length in bytes: Specify the size of the records that are to be written to the 
file. MSRJE always receives 80-character records. If the value you specify 
for the Record Length in bytes prompt is not 80, MSRJE restructures the data 
into records of the size you specify. For example, if you specify 60 for the 
Record length in bytes prompt, three 80-character records received by MSRJE 
will be written to the file you are defining as four 60-character records. If 
you specify 160 for the Record length in bytes prompt, every two 80-character 
records received by MSRJE will be written to the file you are defining as one 
160-character record. 

Normally, the record length for a punch file is 80 or 96 bytes. The default 
record length for punch data directed to a data file is 80 bytes. 

Delete capable file?: Specify whether the file being created is to be a 

delete-capable file. Y specifies that it is; N, the default, specifies that it is not 
delete-capable. 
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If you specified a file type of S (sequential) or D (direct) for the Type of file to be 
created prompt, this completes your definition. The entry menu is displayed. If 
you specified a file type of I (indexed), you must complete one more display. 


MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table punch entry 


FORMEILE 
RESFORM7 


Starting position of the key . 1-4096 1 

Length of the key.1-120 1 

Allow duplicate keys?.N,Y N 


Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. I 

V_ J 


Starting position of the key: Specify the first position of the key within the record, 
which can be any value from 1 through 4096. The default is 1. 

Length of the key: Specify the number of bytes in the key. Any value from 1 
through 120 is valid. The default is 1. 

Note: The value specified for Starting position of the key plus the value specified for 
Length of the key minus 1 must be less than or equal to the defined record 
length. 

ADow duplicate keys?: Specify whether more than one record can have the same 
key value within the file. N (No), the default, specifies that duplicate keys 
are not allowed. Y (Yes) specifies that duplicate keys are allowed. 

If N is specified, duplicate key errors may occur since the host system can 
send duplicate header or trailer records to System/36. 

This completes the definition for a print entry with output to a disk file. The entry 
menu is displayed. 
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I Punch Entry for Compressed Disk Ffle for Disk File Output 


To create a punch entry with output directed to a compressed disk file for a disk 
file, select: 

1. Option 1 (Create a new entry) or option 3 (Add entries to an existing table) on 
the main menu 

2. Option 3 (Punch) on the entry menu 

3. Option 5 (Compressed disk file for a disk file) on the output menu 

If you are updating an existing entry (option 2 on the main menu), the current 
values are presented for the named entry on each of the displays. You can change 
any of those values. After you have selected Punch, and Table entry name on the 
entry menu, and compressed disk file for a disk file on the output menu, the 
following displays are presented. 


I 


MSRJE CONTROL TABLE UTILITY FORMFILE 

RESFORM8 

Create an MSRJE forms control table compressed disk file entry 

Optional-* 

Name of the file to be created ..MSRJE 

User ID.MSRJE 

Number of blocks to be reserved . 1-560872 60 

Number of blocks to extend the file. 0-560872 10 

Preferred disk location . A1,A2,A3,A4,block number A1 ♦ 

Save the file in case of error?.Y,N Y 

Add output to an existing file?.N,Y N 

Free unused file blocks?.Y,N Y 

Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

CORP IBM Corp. 1986 
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Name of the file to be created: Specify the first 6 characters of the name of the file 
to be created when punch output is written to a compressed disk file. MSRJE 
is the default name. 

The file will be named as follows: 

xxxxxxnn 

where: 

xxxxxx is the value you specify for the Name of the file to be created 
prompt. 

nn is the punch file sequence number (as specified on display 36.0 

during MSRJE configuration) if the Add output to an existing 
fUe? prompt is specified as N (No). 

or 

nn is 00 if the Add output to an existing fUe? prompt is Y (Yes). 

User ID: Specify the user ID to be used when output is being written to disk and 
resource security is active. The user ID can be from 1 to 8 characters; the 
default is MSRJE. 

Number of blocks to be reserved: Specify, in decimal, the number of blocks that are 
to be initially allocated for this file. Any number from 1 to 560872 is valid, 
but the specification cannot exceed the amount of available disk storage. The 
default is 60 blocks. 

Number of blocks to extend the file: Specify the number of blocks by which the file 
should be enlarged if the file becomes full. If 0 is specified, the file cannot be 
extended (enlarged). Any decimal value from 0 to 560872 can be specified; 
the default is 10. 

Preferred disk location: Specify either the disk on which you want the file placed or 
the block number at which the file should begin. The file is placed on the: 

• First disk if you specify Al, the default 

• Second disk if you specify A2 

• Third disk if you specify A3 

• Fourth disk if you specify A4 

Al, A2, A3, and A4 are only preferred locations. If the disk you specify is 
full or does not exist, the file is placed wherever there is room. 

A block number can be any 6-digit number less than 560872. Your file is 
placed at the block location you specify only if that location is available. 
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Save the file in case of error?: Specify whether you want the data written to the file 
to be saved if an error occurs before the file is closed. Y (Yes), the default, 
specifies that if an error occurs before all data has been written to the file, the 
system will save the data already written to the file. N (No) specifies that the 
data already written will be lost if an error occurs before the file has been 
closed. 

Note: If you wish to add data to an existing file (see the next prompt), you 

should specify Y for this prompt. If you specify N and an error occurs, 
the entire file, including the data previously in the file, is deleted. 

Add output to an existing file?: Specify whether you want the punch data received 
for this entry to be added to an existing compressed disk file. Y (Yes) 
specifies that you want the data added to file xxxxxxOO, where xxxxxx is the 
value specified for the Name of the file to be created prompt or MSRJE. N 
(No), the default, specifies that you want a new file created, and that file will 
be named xxxxxxnn, where xxxxxx is the value specified for the Name of the 
file to be created prompt, and nn is the punch file sequence number. 

If you specify Y and a file by the specified name cannot be found, a new file 
will be created using that name. 

Notes: 

1. Only one device can use the file at one time. 

2. If you specify yes to this prompt and specified no to prompt 7, Keep kmt data 
sets together on the MSRJE Printer/Punch Attributes display (display 36,0), 
the yes on this prompt will override the no on display 36,0, 

Free unused file blocks?: Specify whether blocks that are not used by the file are to 
be released for use by other files. Specify Y (Yes), the default, or N (No). 

Specify N (No) if the file will be located on a remote system. Unused file 
blocks cannot be released on remote systems. 
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Once you have completed the definition for the compressed disk file, you define 
the characteristics of a data file so that the RJFILE utility (see Chapter 6) can 
convert the compressed file to a data file usable by your programs. The following 
sequence of displays is presented. 


MSRJE CONTROL TABLE UTILITY FORMFILE 

RESFORM8 

Create an MSRJE forms control table punch entry 

Optional-* 

Name of the file to be created.MSRJE 

User ID.MSRJE 

Procedure name. * 

Library name...#LIBRARY 

Type of file to be created.S,D,I S 

Save the file in case of error?.Y,N Y 

Add output to an existing file?.N,Y N 

Free unused file blocks?.Y,N Y 

Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 


Name of the file to be created: Specify the first 6 characters of the name of the file 
that is to be created by MSRJE. MSRJE is the default name. 

The file will be named as follows: 

xxxxxxnn 

where: 

xxxxxx is the value you specify for the Name of the file to be created 
prompt. 

nn is the punch file sequence number (as specified on display 36.0 

during MSRJE configuration) if the Add output to an existing file? 
prompt is specified as N (No) 

or 

nn is 00 if the Add output to an existing file? prompt is Y (Yes). 
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User ID: When resource security is active on System/36, specify the user ID that 
is to be used when punch data is written to disk and when a procedure is 
started by MSRJE. The ID specified can be from 1 through 8 characters. 

Procedure name: Specify the name of a System/36 procedure, if any, that should 
be started by MSRJE or RJFILE after this punch data stream has been 
received. 

When running RJFILE, if the procedure contains a LOAD OCL statement, 
the procedure should also contain a LIBRARY OCL statement with the name 
of the library that contains the program that is to be loaded. If the procedure 
does not contain a library statement, the program that is to be loaded must be 
located in the system library. 

Library name: Specify the name of the System/36 library that contains the 
procedure specified for the previous prompt. 

Type of file to be created: Specify whether you want MSRJE to create a sequential 
file (S, the default), a direct file (D), or an indexed file (I). 

Save the fOe in case of error?: Specify whether you want the data written to the file 
to be saved if an error occurs before the file is closed. Y (Yes), the default, 
specifies that if an error occurs before all data has been written to the file, the 
system will save the data already written to the file. N (No) specifies that the 
data already written will be lost if an error occurs before the file has been 
closed. 

Note: If you wish to add data to an existing file (see the next prompt), you 

should specify Y for this prompt. If you specify N and an error occurs, 
the entire file, including the data previously in the file, is deleted. 

Add output to an existing file?: Specify whether you want the punch data received 
for this entry to be added to an existing disk data file. Y (Yes) specifies that 
you want the data added to file xxxxxxOO, where xxxxxx is the value specified 
for the Name of the file to be created prompt. N (No), the default, specifies 
that you want a new file created, and that file will be named xxxxxxnn, where 
xxxxxx is the value specified for the Name of the fOe to be created prompt, 
and nn is the punch file sequence number. 

If you specify Y and a file by the specified name cannot be found, a new file 
will be created using that name. 

Notes: 

1. Only one device can use the file at one time. 

2. If you specify yes to this prompt and specified no to prompt 7, Keep host data 
sets together on the MSRJE Printer/Punch Attributes display (display 36.0), 
the yes on this prompt will override the no on display 36.0. 

Free unused file blocks?: Specify whether blocks that are not used by the file can 
be released for use by other files. Specify Y (Yes), the default, or N (No). 

Specify N (No) if the disk file will be located on a remote system. Unused file 
blocks cannot be released on remote systems. 
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MSRJE CONTROL TABLE UTILITY 


FORMEILE 
RESFORM8 


Create an MSRJE forms control table punch entry 

Optional-* 

Number of blocks to be reserved . 1-560872 60 



Number of blocks to be reserved: Specify, in decimal, the number of blocks that are 
to be initially allocated for this file. Any number from 1 to 560872 is valid, 
but the specification cannot exceed the amount of available disk storage. The 
default is 60 blocks. 

Number of blocks to extend the file: Specify the number of blocks by which the file 
should be enlarged if the file becomes full. If 0 is specified, the file cannot be 
extended (enlarged). Any decimal value from 0 to 560872 can be specified; 
the default is 10. 

Preferred disk location: Specify either the disk on which you want the file placed or 
the block number at which the file should begin. The file is placed on the: 

• First disk if you specify Al, the default 

• Second disk if you specify A2 

• Third disk if you specify A3 

• Fourth disk if you specify A4 

Al, A2, A3, and A4 are only preferred locations. If the disk you specify is 
full or does not exist, the file is placed wherever there is room. 

A block number can be any 6-digit number less than 560872. Your file is 
placed at the block location you specify only if that location is available. 
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Record length in bytes: Specify the size of the records that are to be written to the 
file. MSRJE always receives 80-character records. If the value you specify 
for the Record length in bytes prompt is not 80, MSRJE restructures the data 
into records of the size you specify. For example, if you specify 60 for the 
Record length in bytes prompt, three 80-character records received by MSRJE 
will be written to the file you are defining as four 60-character records. If 
you specify 160 for the Record length in bytes prompt, every two 80-character 
records received by MSRJE will be written to the file you are defining as one 
160-character record. 

Normally, the record length for a punch file is 80 or 96 bytes. The default 
record length for punch data directed to a data file is 80 bytes. 

Delete capable fOe? Specify whether the file being created is to be a delete-capable 
file. Y specifies that it is; N, the default, specifies that it is not 
delete-capable. 

If you specified a file type of S (sequential) or D (direct) for the Type of fUe to be 
created prompt, this completes your definition. The entry menu is displayed. If 
you specified a file type of I (indexed), you must complete one more display. 


MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table punch entry 


Starting position of the key . 1-4096 

Length of the key.1-120 

Allow duplicate keys?.N,Y 



Cmd3-Save entry, display entry menu 


Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 

_ J 
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Starting position of the key: Specify the first position of the key within the record, 
which can be any value from 1 through 4096. The default is 1. 

Length of the key: Specify the number of bytes in the key. Any value from 1 
through 120 is valid. The default is 1. 

Note: The value specified for Starting position of the key plus the value specified for 
Length of the key minus I must be less than or equal to the defined record 
length. 

Allow duplicate keys?: Specify whether more than one record can have the same 
key value within the file. N (No) the default, specifies that duplicate keys are 
not allowed. Y (Yes) specifies that duplicate keys are allowed. 

If N is specified, duplicate key errors may occur since the host system can 
send duplicate header or trailer records to System/36. 

This completes the definition for a punch entry with output to a compressed disk 
file for a disk file. The entry menu is displayed. 


Punch Default Entry 


One punch default entry is defined for each control table. This entry will be used if 
there is no entry in the active control table that matches the received host forms 
name. Whenever you create a new table (option 1 on the main menu), the control 
table utility automatically inserts a punch default entry in that file. Therefore, you 
cannot create or add a punch default entry, but can update the existing entry. 

When you enter the Table entry name, or leave it blank, on the entry menu, a 
message is displayed telling you that the entry exists. Press the Enter key to update 
the entry. 

Updating a punch default entry is the same as updating a punch entry with data file 
output or a punch entry with compressed disk output, except that option 4 (Punch 
default entry) must be specified on the entry menu. 

You can remove a punch default entry that you have updated. The control table 
automatically replaces the removed entry with the original entry containing the 
values supplied by IBM. 

The default values supplied by IBM are shown in Appendix D. 
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Chapter 6. MSRJE Disk FOe Utility 


The MSRJE disk file utility (RJFILE) allows you to convert punch data that 
MSRJE wrote to a compressed disk file (a file with 256-byte unprocessed records) 
to files that you define. You can also use RJFILE to convert print files that 
MSRJE wTOte to a compressed disk file or to send print data to files that you 
define. 

The disk file utility requires the following: 

• Disk files containing 256-byte unprocessed records as created by MSRJE. 

• Utility control statements. 

• A forms control table to control the output of RJFILE (optional). 


Disk File Input to the Disk File Utility 

Input to the disk file utility can be: 

• Punch files, created by an MSRJE session, that contain 256-byte unprocessed 
records. These files can be converted to disk data files using RJFILE. 

• Print files, created by an MSRJE session, that contain 256-byte unprocessed 

I records. These files can be printed or converted to a disk data file using 

RJFILE. 

A single file can contain both print and punch data. 


Starting the Disk File Utility 

The MSRJE disk file utility can be run by either entering the RJFILE procedure 
command or by entering the OCL statements needed by the utility. 
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Using the RJFILE Procedure Command 


The RJFILE procedure command is used to start the MSRJE disk file utility. The 
format of the procedure command is: 

RJFILE filename[ , control-table-name] 

filename: Specifies the name of the disk file that is to be converted or printed using 
RJFILE. 

If the fUename parameter is not specified, you will be prompted for the input 
file name. If the RJFILE procedure is entered from the job queue, the 
fUename parameter must be specified on the procedure command. If it is not, 
a message is displayed at the system console, and the job canceled. 

control-table-name: Specifies the name of the control table that RJFILE is to use 
to control the conversion or printing. The control table named must have 
been created using the control table utility. The control table utility is 
described in Chapter 5. 

If you do not specify the control-table-name parameter, the disk file utility 
uses the default values for print or punch data as described in Appendix D. 

Using OCL Statements to Run the Disk File Utility 

If you prefer, you can enter OCL statements to run the MSRJE disk file utility. 

The following statements are needed: 

// LOAD #RJFILE 

// RUN 

// COPYFILE NAME-filename[,DATE-date][,CTNAME-name] 

// END 

The COPYFILE statement specifies the file that is to be used as input to the utility 
and specifies the name of the file that contains the control table to be used by the 
RJFILE procedure. The parameters are: 

NAME: Specifies the name of the file created by MSRJE that is to be used as 
input to the disk file utility. 

DATE: Specifies the creation date of the file to be used as input. The date must 
be entered in the system date format. If no date is entered, the named file 
with the latest creation date is used. 

CTNAME: Specifies the name of the file that contains the control table, as created 
by the MSRJE control table utility, that is to be used to control creating a 
disk file from punch data or printing print data. If the CTNAME parameter is 
not specified, the disk file utility uses the IBM-supplied default values for 
print or punch data, as described in Appendix D. 

You can enter as many COPYFILE statements as needed to process your input 
files. All COPYFILE statements must be placed before the END statement. 
User-written procedures can also specify multiple COPYFILE statements. 
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Chapter 7. Defining MSRJE to a BSC Host System 


This chapter contains information that is needed by the host system programmer to 
properly configure a communications network that includes System/3 6 running 
MSRJE. The information given here is intended to point out those items that are 
needed to support MSRJE; it is not intended to be a reference document for 
configuring a host system. Changes to the parameters and their default values 
sometimes occur between releases. Therefore, the information given here may not 
exactly reflect the host subsystem release with which you are operating. 


System Components 

When MSRJE is used with a BSC data link, System/36 is the remote station in the 
communications network and initiates communications with the host system by 
sending a logon/signon sequence. Communications can be over a point-to-point 
switched or leased line. 

BSC MSRJE supports communications with the following host subsystems: 

• OS/VS2 Job Entry Subsystem 2 (JES2) 

• OS/VS2 Job Entry Subsystem 3 (JES3) 

• OS/VSl Remote Entry Services (RES) 

• VM/370 Remote Spooling Communications Subsystem (RSCS) 

MSRJE with a BSC data link requires the following components on the host 
system: 

• 270x or 37xx Communications Controller and Network Control Program 
(NCP). 

• Appropriate communications access method (depending on the host 
subsystem). 

• An operating system (OS/VSl or OS/VS2 (MVS or VM/370)). 

The relationship of these components to each other is shown in Figure 7-1. 
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Figure 7»1 (Part 2 of 4). BSC Components 
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Figure 7-1 (Part 3 of 4). BSC Components 
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Figure 7-1 (Part 4 of 4). BSC Components 
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Commimications ControOer and the NCP 


The IBM 37xx Communications Controllers provide communications control by 
means of the Network Control Program (NCP). A communications controller and 
its NCP support a variety of remote terminals attached to the controller. The NCP 
is generated from a series of user-specified macroinstructions. An NCP can be 
generated to handle lines in either network control mode, or emulation mode, or 
both. An NCP that is generated with both kinds of functions is called an NCP with 
the Partitioned Emulation Programming (PEP) extension. 

Remote Terminal Access Method (RTAM), JES2, and JES3 use the facilities of the 
NCP to control lines and devices attached to the controllers, to transmit and 
receive data, and to perform error recovery. Virtual Telecommunications Access 
Methods (VTAM) executes macroinstructions to direct the acquisition, reading, 
writing and checking of data from the terminals to which it is connected. 

For additional information on the communications controllers and the NCP, see the 
Introduction to the IBM 3704 and 3705 Communications Controllers. 

Communications Access Methods 


RTAM 


RTAM is a communications access method used by RES for BSC operations. All 
work stations, communications line, and transmission code dependencies are 
resolved by RTAM. 

RTAM is started on a communications line basis rather than on a work station 
basis. To initiate processing, the central operator issues a START RTAM 
command, which, in turn, starts one or more communications lines. Additional 
lines can be started later by entering a MODIFY command specifying lines that 
were previously allocated to RTAM. Any work station compatible with the line 
adapter and data set (for switched hnes) attached to the line can establish 
connection with RES through a LOGON procedure that identifies the particular 
work stations or work station user. 


JES2 


The Remote Job Entry (RJE) facility of JES2 allows remote work stations to use 
the Job Entry Subsystem. To initiate processing, the system operator starts one or 
more lines by entering the $S Start command. Any work station compatible with 
the line adapter and data set (for switched lines) attached to the line can establish 
connection with JES2 through a SIGNON procedure that identifies the particular 
work station or work station user. JES2 uses RTAM to provide an interface 
between JES2 and the remote work station. 
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JES3 


JES3 uses RTAM to provide an interface between JES3 and the remote work 
station. RTAM provides blocking/deblocking, compression/decompression, and 
synchronization with the remote terminal. To initiate processing, the system 
operator enters a *START LINE command. Any work station compatible with the 
line adapter and data set (for switched lines) attached to the line can establish 
connection with JES3 through a SIGNON procedure that identifies the work 
station or work station user. 


VM/370 RSCS 


The SML (Spool MULTILEAVING) line driver operates as a task under the RSCS 
component of VM/370, and provides VM/370 with the support for the 
MULTILEAVING binary synchronous communications line protocol for 
programmable remote work stations. 

The SML line driver, when communicating with System/36 MSRJE, functions in a 
host mode. In host mode, SML follows a common protocol for all remote work 
stations. 

Notes: 

1. Forms control buffer images are ignored. 

2. RSCS does not support sending forms mount messages for punches. Therefore, 
default entries in the forms control table are used. 
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JES2 Host System Generation 


When JES2 is started, a series of initialization parameters are processed to 
determine the configuration options to be used. Initialization parameters that are 
required for System/36 RJE work stations can be characterized as: (1) 
system-wide initialization values and (2) remote work station definitions. 

JES2 System-Wide Initialization Parameters 

The following JES2 system-wide initialization parameters are used to define BSC 
work stations running RJE. For a complete description of JES2 initialization 
parameters, see the manual OS/VS2 MVS System Programming Library: 
Initialization and Tuning. 

&MLBFSIZ=niiim (MULTILEAVING Buffer Size): Specifies the size, in bytes, of 
each JES2 MULTILEAVING buffer. The value specified must match the value 
specified for the prompt Buffer length on display 11.0 during line member 
configuration at System/36. 

Default: 400 

&NUMBUF=nmin (JES I/O Buffer Count): Specifies the number (15 through 
2000) of I/O buffers to be included in the JES2 load module. Refer to OS/VS2 
MVS System Programming Library: Initialization and Tuning for information on 
calculating this value. 

&NUMCMBS=nnnn (Number of JES2 Console Message Buffers): Specifies the 
number (3 through 999) of console message buffers to be provided for JES2. 
When RJE is used, more buffers are usually needed; this is especially true with 
console support for MULTILEAVING terminals. Specifying too few message 
buffers can cause serious performance degradation. 

During periods of high console activity when no message buffers are available, 
certain noncritical JES2 messages are discarded. 

For a MULTILEAVING terminal console, if more messages are queued than the 
number of buffers specified in this parameter, excess messages are spooled and 
printed later. 

Default: 15 
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&NUMJOES=iinim (Number of Job Output Elements): Specifies the number of 
job output elements to be generated. One job output element is required for each: 

• Unique punch or print class that appears in a job that is queued for output. 

• Active printer or punch. 

• Interrupted or restarted job that is not currently active on printer or punch. 

• Unique combination of forms ID, USCID, and FCB ID for all jobs currently 
queued for output. 

• Job that was interrupted by a system failure while being printed or punched 
and has not yet been warm started on an output device. 

Specifying too small a value results in jobs waiting for in-storage queuing in order 
to complete active print or punch work. For performance, you should specify a 
number slightly larger than the total of the above elements. 

Default: 10 times the total number of local and remote printers and punches. 

&NUMLNES=iimm (Number of Teleprocessing Lines): Specifies the maximum 
number of LINEnnn initialization parameters that can be specified. This value 
includes the number of lines defined either as BSC MULTILEAVING lines or as 
logical lines for SNA. 

Default: 0 

&NUMRJE=nnnn (Number of Remote Terminal Definitions): Specifies the number 
(0 through 255) of remote terminal definitions (RMTnnn). This value should 
correspond to the highest number used as an RMTnnn initialization parameter. 

Default: The value specified for the &NUMLNES parameter. 

&PRTRANS=YES/NO (Print Line Translation Option): Specifies whether to 
translate lines of print directed to remote printers. If the default value (yes) is 
used, each line to be printed is translated by changing: 

• Lowercase to uppercase 

• Characters that are invalid on a print train to blanks 

If any print train on a remote printer has characters not equivalent to those on a 
train, NO must be specified. 

In BSC, if the remote printer is on a nontransparent line, translation occurs 
regardless of the value specified for &PRTRANS. 

Default: YES. 
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&SPOLMSG=iinn (Remote Terminal Spool Mess^^e Record Count): Specifies the 
number (0 through 254) of physical records to be reserved for operator messages 
and JES2 messages for each JES2 remote terminal. 

Default: (4096/&BUFSIZE) x 6 if &NUMLNES is not 0; 

0 if &NUMLNES is 0. 

&TPBFSIZ=nnnn (Teleprocessing Buffer Size): Specifies the largest 
telecommunications buffer size in bytes required for any remote work station. 
During initialization, JES2 adjusts the &TPBFSIZ value to equal the &MLBFSIZ. 

Default: 400 

&TPIDCT=nnn (Remote Printer Separator Page Line Count): Specifies the number 
(0 through 255) of print lines that are to appear on each JES2 job output separator 
page for remote terminal printers. If the specification is 30 or greater, the first 29 
lines are used to produce a block-lettered job name, job number, and SYSOUT 
class. 

Default: 6 

&WAITIME=nn (Remote Terminal Function Interval): Specifies the length of time 
in seconds (1 through 30) JES2 waits after processing an input stream or output 
stream to allow entry of commands or jobs by the MSRJE operator. 

Default: 1 


i 
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Remote Work Station Definitions for BSC MULTILEAVING 


JES2 remote work station definitions for BSC MULTILEAVING consist of a 
series of LINEnnn, RMTnnn, Rnnn.PRm, Rnnn.PUm, and Rnnn.RDm parameters. 


LINEnnn (Line Definition) 


The LINEnnn parameter defines the characteristics of one telecommunications line 
to be used during remote job entry. This parameter must be specified for each line. 

nnn specifies an identification number for the line. All lines must have a unique 
number in the range 1 through 255 that is equal to or less than the value specified 
for &NUMLNES. Do not use leading zeros for nnn. 

The following LINEnnn subparameters are used in defining BSC 
MULTILEAVING work stations. 

HISPEED/LOWSPEED: Specify LOWSPEED (less than or equal to 9600 bits 
per second). 

Default: LOWSPEED, which specifies that this is a low-speed line (less than or 
equal to 9600 bits per second). 

PASSWORD=ccccccccc: Specifies a security password to prevent unauthorized 
work stations from using this line. The value specified (1 through 8 alphameric 
characters) must match the entry made for the passwordl parameter of the 
SIGNON command on display 35.0 during MSRJE subsystem configuration at 
System/36. 

Default: No password. 

TRANSP/NOTRANSP: Specifies whether transparent data is to be transmitted 
(any 8-bit character). 

Default: NOTRANSP, which specifies that the text transparency feature of the 
BSC adapter is not present on this line. 

USASCII/EBCDIC: You must specify EBCDIC. 

Default: EBCDIC, which specifies that the BSC adapter is configured for 
EBCDIC line control characters. 
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RMTnnn (Remote Work Station Definition) 


The RMTnnn parameter specifies the characteristics of one remote work station. 
One RMTnnn parameter is required for each work station. 

nnn specifies an identification number for the work station. Work stations are 
numbered consecutively from 1 through 255. Do not use leading zeros for nnn. 

The highest value specified for nnn must match the value specified for &NUMRJE. 

The following subparameters of RMTnnn are used in defining BSC 
MULTILEAVING work stations. 

SYSTEM36: Specifies that this remote work station is a System/36. This 
subparameter is required for the System/36 to handle job names correctly. 

MSG150/NOMSG150: MSG 150 specifies that a $HASP150 message is sent to 
the host. This subparameter is required for the System/36 to handle job names 
correctly. 

CONSOLE/NOCON: CONSOLE specifies that this work station has an operator 
console or that it is simulating a console. 

Because System/36 supports a console, specify CONSOLE. 

Default: NOCON, which specifies that this work station has no operator console. 

DISCINTV=niinn: Specify DISCINTV=0 (a 0 specifies this work station is not to 
be disconnected if there is no text transmission in either direction). 

Default: 0, which specifies that this terminal is not to be disconnected. 

FIXED/VARIABLE Specify VARIABLE (variable data record length). 

Default: VARIABLE. 

MULTI/HARDWARE: MULTI specifies that this terminal will use the BSC 
MULTILEAVING interfaces. If MULTI is specified, the terminal type must 
specify MULTILEAVING work stations. Specify MULTI. 

Default: HARDWARE, which specifies that this terminal will not use the BSC 
MULTILEAVING interfaces. 

NUMPR=n: Specifies the number of printers at this remote terminal. Specify from 
0 through 7 for System/36. The value specified here should not be greater than 
the value entered for the prompt Maximum number of printers on display 36.0 
during MSRJE subsystem configuration at System/36. 

Default: 1 
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NUMPU=n: Specifies the number of punch devices at this remote terminal. 
Specify from 0 through 7 for System/36. The value specified here should not be 
greater than the value entered for the prompt Maximum number of punches on 
display 36.0 during MSRJE subsystem configuration at System/36. 

Default: 0 

Note: The total number of printers (NUMPR) and punches (NUMPU) cannot 
exceed 8. 

NUMRD=n: Specifies the number of readers at this remote terminal. Specify 
from 1 through 7 for System/36. This value must be at least as large as the value 
entered for the prompt Maximum number of host readers on display 37.0 during 
MSRJE subsystem configuration at System/36. 

Default: 1 

PASSWORD=ccccccccc: Specifies a security password (1 through 8 alphameric 
characters) to prevent unauthorized terminals from using this remote terminal’s 
resources. If used, this entry must match the entry made for the password! 
parameter of the SIGNON command on display 35.0 during MSRJE subsystem 
configuration at System/36. 

Default: No password. 

ROUTECDE=nnn: Specifies the route code to be assigned to this terminal and its 
associated printers, punches, and readers. The value of nnn may be any number 
from 1 through the value of &NUMRJE. 

Default: If a route code is not specified, JES2 assigns the number of this terminal 
(RMTnnn) as its route code. 

SETUPINF/SETUPACT: SETUPINF specifies that operator setup messages 
issued at the local (CPU) console for this remote device are to be informational 
messages (they do not require an operator action to be deleted from a display 
console). Specify SETUPINF for System/36. 

Default: SETUPACT, which specifies that operator setup messages issued at the 
local console for this remote device are flagged as action messages (requiring a 
operator action to be deleted from a display console). 

TRANSP/NOTRANSP: TRANSP specifies that this terminal has the text 
transparency feature. To be effective, the TRANSP subparameter must also be 
specified for the line (LINEnnn initialization parameter) being used. Specify 
TRANSP here only if the prompt Transparency? on display 37.0 during MSRJE 
subsystem configuration at System/36 was responded to with Y (Yes). 

Default: NOTRANSP, which specifies that this terminal does not have the text 
transparency feature. 
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Rnim.PRm (Remote Printer Definition) 


The Rnnn.PRm parameter specifies the characteristics of one printer at a remote 
work station. 

nnn specifies the number of the work station as specified in an RMTnnn 
initialization parameter. This associates the printer with this work station. 

m specifies the number of this printer. 

The number of printers defined using the Rnnn.PRm parameter must match the 
number of printers specified for the NUMPR subparameter of the RMTnnn 
parameter. 

The following subparameters further define the remote work station printer. 

AUTO/OPERATOR: AUTO specifies that this printer is to operate initially in 
automatic (demand) forms mode when JES2 starts processing. Specify AUTO for 
System/36. 

Default: OPERATOR which specifies that this printer is to operate initially in 
operator controlled (forms) mode. 

The mode may be modified from the remote terminal via the JES2 $T set 
command. 

CKPTLNS=nnnnn: Specifies the maximum number of lines (0 through 32767) in a 
page. The size of a logical page is also defined as the number of lines printed until: 

• A channel skip is encountered. 

• The line count specified by &LINECT, the /*JOBPARM control statement, or 
the JOB statement accounting field has been exceeded. 

If CKPTLNS is 0, a logical page is defined only by the preceding items. 

If the line count does not equal 0, setting CKPTLNS to a value greater than line 
count results in the line count being used as the definition of a logical page; it 
overrides CKPTLNS. 

CKPTLNS, in conjunction with CKPTPGS, is used to specify the checkpoint 
interval for data sets having a line count of 0 and no channel skips. 

Default: 0 
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CKPTPGS=iiiiiiiin: Specifies the number of logical pages (1 through 32767) to be 
printed before each checkpoint is taken. 

The CKPTPGS and CKPTLNS parameters determine the number of logical 
records sent to the remote before a checkpoint is taken. The number of records 
sent equals CKPTPGS times CKPTLNS. The checkpoint is not taken until JES2 
receives acknowledgement that the remote terminal successfully received the data. 

Default: 1 

CLASS=cl.„cn: Specifies the output classes, in priority sequence, to be processed 
initially by this printer. You can specify any number of classes (A through Z and 0 
through 9) up to the maximum number of classes specified by the &NUMCLAS 
parameter. 

Default: AJ (where A and J are classes assigned to this printer). 

DRAIN/START DRAIN specifies that this printer is to be started by operator 
command. START, which specifies that the printer is to be started automatically 
when JES2 starts processing, should be specified for System/36. 

Default: START. 

FORMS =cccc: Specifies the forms identifier of the forms that are assumed to be 
initially loaded in this printer (1 through 4 alphameric characters). 

Default: If no value is specified, JES2 will use the forms identifier specified by the 
&STDFORM generation parameter. 

LIMIT=(m-n,in-*): The LIMIT subparameter allows you to specify that output is 
to be selected for specific printers based upon the amount of the output (in 
records). The values m and n specify within what output size range (in records) a 
job output element (JOE) must fall to be processed by this printer. The integer m 
specifies the lower output size limit and n specifies the upper output size limit. The 
value of m must be less than the value of n. The maximum value that can be 
explicitly assigned to n is 999999 records. If * is specified, the upper limit is set to 
the default value of n (4294767295). 

Default: m equals 0, and n equals 4294767295. 

NOSEP/SEP: NOSEP specifies that separator pages are not to be provided 
initially between data set groups. 

Default: SEP, which specifies that separator pages are to be provided initially 
between data set groups. 

Note: If 0 print lines were specified by the &TPIDCTparameter, separator pages 
will not be produced even if SEP is specified. 
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PRWIDTH=nim: Specifies the maximum number of characters to be printed on 
one line. Specify 198 only if you are using a forms control table entry with a 
printwheel ID which has a CPI=15, or if you are using a print image of CPI=15 
when using a printer which supports a CPI= 15. Specify 132 if you are not using a 
printwheel ID which has a CPI=15. 

Default: 120 

ROUTECDE=nmi: Specifies the route code (1 through 255) to be assigned to this 
printer. The route code specified may be that of any remote terminal defined to 
JES2 by the RMTnnn initialization parameter. 

Default: JES2 assigns the route code of the remote terminal to which the printer is 
attached. (See the description of the RMTnnn parameter in this chapter for more 
information about the route code.) 

Rmm.PUm (Remote Card Punch Definition) 

The Rnnn.PUm parameter specifies the characteristics of one punch at a remote 
work station. 

nnn specifies the number of the work station as specified in an RMTnnn 
initialization parameter. This ties the punch to a work station. 

m specifies the number of this punch. 

The number of punches defined using the Rnnn.PRm parameter must match the 
number of punches specified for the NUMPU subparameter of the RMTnnn 
parameter. 

The following subparameters are used to further define the remote card punch. 

AUTO/OPERATOR: AUTO, which specifies that this punch is to operate initially 
in automatic (demand) forms mode when JES2 starts processing, should be 
specified for System/36. 

Default: OPERATOR, which specifies that this punch is to operate initially in 
operator controlled (forms) mode. The mode may be modified from the remote 
terminal via the JES2 $T set command. 

CKPTLNS=nnnnn: Specifies the maximum number of cards (0 through 32767) to 
be punched per logical page. 

CKPTLNS is the only value used to define a logical page for punches. 

Default: 100 


7-16 Multiple Session Remote Job Entry Guide 



CKPTPGS=iiiinim: Specifies the number of logical pages (1 through 32767) to be 
punched before each checkpoint is taken. 

The CKPTPGS and CKPTLNS parameters determine the number of logical 
records sent to the remote before a checkpoint is taken. The number of records 
sent equals CKPTLNS times CKPTPGS. The checkpoint is not taken until JES2 
receives acknowledgment that the remote successfully received the data. 

Default: 1 

CLASS=cl...cn: Specifies the output classes, in priority sequence, to be processed 
initially by this punch. You can specify any number of classes (A through Z and 0 
through 9) up to the maximum number of classes specified by the &NUMCLAS 
parameter. 

Default: BK (where B and K are classes assigned to this remote punch). 

DRAIN/START: DRAIN specifies that this punch is to be started by operator 
command. START, which should be specified for System/36, specifies that this 
punch (if it is ready) is to be started automatically when JES2 starts processing. 

Default: START. 

FORMS=cccc: Specifies the forms identifier of the forms that are assumed to be 
initially loaded in this punch (1 through 4 alphameric characters). 

Default: JES2 will use the identifier specified by the &STDFORM generation 
parameter. 

LIMIT=(m-n,m-*): The LIMIT subparameter allows you to specify that output is 
to be selected for specific punches based upon the amount of the output (in 
records). The values m and n specify within what output size range (in records) a 
job output element (JOE) must fall to be processed by this punch. The integer m 
specifies the lower output size limit and n specifies the upper output size limit. The 
value of m must be less than the value of n. The maximum value that can be 
explicitly assigned to n is 999999 records. If * is specified, the upper limit is set to 
the default value of n (4294767295). 

Default: m equals 0, and n equals 4294767295. 

NOSEP/SEP NOSEP specifies that separator cards are not to be provided initially 
between data set groups. 

Default: SEP, which specifies that separator cards are to be provided initially 
between data set groups. 

ROUTECDE=imn: Specifies the route code (1 through 255) to be assigned to this 
punch. The route code specified may be that of any remote terminal defined to 
JES2 by the RMTnnn initialization parameter. 

Default: JES2 assigns the route code of the remote terminal to which the punch is 
attached. (See the description of the RMTnnn parameter in this chapter for more 
information about the route code.) 
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Riuin.RDm (Remote Card Reader Definition) 


The Rnnn.RDm parameter specifies the characteristics of one logical reader at a 
remote work station. Specify one Rnnn.RDm parameter for each reader at the 
work station. 

nnn specifies the number of a work station as specified in an RMTnnn parameter, 
m specifies the number of this card reader. 

The number of punches defined using the Rnnn.PRm parameter must match the 
number of readers specified for the NUMRD subparameter of the RMTnnn 
parameter. 

The following subparameters further define the remote reader: 

CLASS=c: Specifies the job class to be assigned to all jobs that are entered at this 
card reader and that do not specify a job class in the CLASS operand of their JOB 
statements. The value c can be any class A through Z and 0 through 9. 

Default: A 

DRAIN/START: DRAIN specifies that this card reader is to be started by 
operator command. START, which should be specified for System/36, specifies 
that this card reader is to start automatically when JES2 starts processing. 

Default: START. 

HOLD/NOHOLD: HOLD specifies that all jobs entered at this card reader are to 
be held after JCL conversion until they are released for execution by the operator. 

Default: NOHOLD which specifies that jobs entered at this card reader are to be 
queued as usual. 
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MSGCLASS=c: Specifies the default message class to be assigned to jobs that are 
entered at this card reader and that do not specify a MSGCLASS operand in their 
JOB statements. The value c can be any class A through Z and 0 through 9. 

Default: A 

PRDEST=iinn: Specifies the printer destination for the printed output from all 
jobs that are entered at this card reader that do not have a ROUTE statement or 
BEST parameter. 

Default: The route code (ROUTECDE) specified in the RMTnnn parameter for 
this remote terminal. 

PRIOINC=im: Specifies a number (0 through 15) to be added to the selection 
priority of each job entered at this card reader. 

Default: 0 

PRIOLIM=iin: Specifies the maximum priority level (0 through 15) that can be 
assigned to jobs entered at this card reader. 

Default: 15 

PRLCL/PRRMT: PRLCL specifies that the route code specified by PRDEST is 
that of a local printer. 

Default: PRRMT, which specifies that the route code specified by PRDEST is that 
of a remote printer. 

PUDEST=nnn: Specifies the card punch destination for the punched output from 
jobs entered at this card reader that do not have a ROUTE statement or a BEST 
parameter. 

Default: The route code (ROUTECDE) specified in the RMTnnn parameter for 
this remote terminal. 

PULCL/PURMT: PULCL specifies that the route code specified by PUDEST is 
that of a local card punch. 

Default: PURMT, which specifies that the route code is that of a remote card 
punch. 

In addition to the JES2 parameters, an NCP generation for the 37xx may be 
necessary. For additional information, refer to the NCP generation information in 
this chapter. 
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JES3 Host System Generation for BSC 


V y 

Parameters specified on the following JES3 initialization statements effect JES3 
BSC Remote Job Processing (RJP) execution and operation. For a complete 
description of JES3 generation, see the manual OS/VS2 MVS System Programming 
Library: JESS. 

CONSOLE (RJP Operators Console) 

Each terminal that requires real or simulated console support should be specified 
with a CONSOLE initialization statement. This statement is used to assign JES3 
destination classes to that console. Only one console can be specified on each 
CONSOLE statement. The following parameters make up the CONSOLE 
statement: 

JNAME=name: Specifies the name of the BSC RJP terminal. This name must 
match the name specified in the N parameter on a RJPTERM statement. 

TYPE=RJP: Specifies that the console being defined is an RJP console. 

DEST=destcode: Specifies one or a series of destination codes that represent 
message classes to be directed to this console. 

The following are values which can be specified for destcode. They represent the 
96 JES3 message categories: 

ALL: Specifies that messages issued by the operator with the destination 
specified as ALL will be routed to all consoles regardless of what is specified in 
the BEST parameter of the CONSOLE statement unless DEST=NONE is 
specified. 

ERR: Console receives messages concerning equipment failure as well as JES3 
failsoft messages, 

JES: Console receives general information messages pertaining to the operation 
of the global processor. 

LOG: Console receives messages concerning active jobs, such as job started or 
job ended. 

MN: Console receives all input and output messages, except security messages, 
providing that MLOG is specified in the HARDCOPY parameter of the 
CONSTD statement. This is in addition to the original source consoles or 
destination consoles which also receive the messages. 

SEC: Console receives security messages. 

TAP: Console receives messages which apply to the JES3 background utilities 
with JES3-controlled tape requirements, such as tape-to-print or card-to-tape. 

TP: Console receives messages which apply to RJP teleprocessing equipment. / 

V.. 
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UR: Console receives messages which apply to the operation of JES3 controlled 
unit record equipment. 

BALL D1 to Dll: Console receives messages that apply to a user defined 
console configuration. Either all of the messages in this group may be selected 
for this console by specifying DALE, or specific classes in the group may be 
selected by specifying one or a subset from D1 through D22. 

MALL Ml to M32: Console receives messages which are unique to an ASP 
main, JES3 local or JES3 global processor. Either all of the messages in this 
group may be selected for this console by specifying MALL, or specific classes 
in the group may be selected by specifying one or a subset from Ml to M32. 

The destination code is associated with a processor by the MDEST parameter in 
the MAINPROC statement. 

SALL SI to S32: Console receives messages which pertain to JES3 device set 
up. Either all of the messages in this group may be selected for this console by 
specifying SALL, or specific classes in the group may be selected by specifying 
one or a subset from SI through S32. Setup messages regarding a specific 
device are associated with this console by indicating the destination code 
selected from this group in the JUNIT or XUNIT parameter on the DEVICE 
statement. 

NONE: Console does not receive any messages. This destination code is not 
correlated to any message class. 

OUTPUT: Console receives messages in all classes except MLG. This 
destination code is not correlated to any message class. 

TOTAL: Console receives messages from all 96 message classes including 
MLG. This destination code is not correlated to any message class. 

DEPTH=iinn: Specifies the maximum number of messages to be maintained in the 
buffers associated with a RJP console. The DEPTH may be from 1 to 255. When 
an RJP console is queued to depth, the queued messages are written to spool. To 
keep track of the status of console buffers, use the ^INQUIRY operator command. 

Default: 50 

LL=iimi: Specifies the longest line length to be printed on this console. If the 
actual line to be written exceeds this length, the line is broken at a comma or a 
blank and continued on the next line. 

Default: 120 

LEVEL=im: Specifies the authority level (0 through 15) for the JES3 console 
authority routine (IATUX18) to check for validity. 

Default: 0 
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DEVICE (Device Definition) 


The DEVICE statement defines those devices used by JES3 and those devices used 
by jobs running under JES3. Each uniquely addressable device (card reader, 
punch, local or remote console, or printer) attached to a global, local, or ASP main 
processor must be specified on a DEVICE statement if the default characteristics 
are not satisfactory. The* default characteristics are provided by the RJPTERM 
initialization statement. Refer to the OS/VS 2 MVS System Programming Library: 
JESS manual for the DEVICE statement parameter descriptions. 

RJPLINE (Remote Job Processing Line) 

The RJPLINE statement is necessary to define the characteristics of a single BSC 
line (and it’s respective adapter) which will be used by the JES3 global processor 
for remote job processing. Additionally, this statement may assign a specific RJP 
work station, defined by the N parameter of an RJPTERM statement, to this line. 
One RJPLINE statement is required for every adapter to be accessed by RJP. The 
following parameters make up the RJPLINE statement: 

N=linename: Specifies the name for this line. This name must not be the same as 
the name specified by the n parameter of an RJPWS or RJPTERM initialization 
statement. 

A=adapter: Specifies the 3-character line adapter address associated with this line. 

F=DIAL; F=NTRS: Used to indicate a dial feature for this line (DIAL) and/or 
the absence of a transparency feature for the line (NTRS). If both DIAL and 
NTRS are selected, both F parameters are specified, as F=DIAL and F=NTRS. 

If the prompt Transparency? was responded to with a Y on display 37.0 during 
MSRJE subsystem member configuration at System/36, do not specify F=NTRS. 

Default: Dedicated or leased line environment. Transparency feature assumed on 
terminals on this line. 

G=grpname: Indicates a line group name of up to 8 characters, which associates 
several lines. 

Default: 8 blanks. 

I=B/A: B refers to the second interface of the BSC adapter. A refers to the first 
interface of the BSC adapter. 

Default: A 
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I=Y/N: Y specifies the interrupt mode of operation. N specifies the noninterrupt 
mode of operation. 

Default: Y 

0=AUT0: Indicates the line option to have the RJP line start automatically; the 
♦START operator command is not required. 

Default: *START operator command is required. 

P=password: Provides for password protection for this line. P indicates a line 
password of 1 to 8 alphameric characters. This password must be used by any 
work stations attempting to sign on to this line. 

The value specified for the passwordl parameter in the host SIGNON command on 
display 35.0 during MSRJE subsystem member configuration at System/36 must 
match the value specified here. 

Default: 8 blanks. 

S=linespeed: Indicates a line baud rating up to 6 characters. 

Default: 2400 

T=teniiname: Indicates a terminal to be assigned to this line. If this parameter is 
included, the /*signon card must not be used. T specifies the name (up to 5 
characters) of a nonprogrammable terminal. This name must also appear in the N 
parameter of an RJPTERM statement and NAME parameter of a CONSOLE 
statement. The T parameter must not be specified when F=DIAL is specified. 
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RJPTERM (BSC Remote Job Processing Terminal) 


The RJPTERM statement defines a single remote BSC work station to the JESS 
system. This statement causes a default description to be provided for each work 
station device (printer, punch, or card reader) indicated by the PR, PU, and RD 
parameters along with the operating characteristics of the work station. If the JESS 
default characteristics for a remote printer or punch are not acceptable, a DEVICE 
statement should be coded to indicate desired characteristics. If a work station is 
to have the facilities of a JESS operator console, then a CONSOLE statement must 
be coded. 

N=name: Required to indicate the name for this work station. This name must be 
5 characters and cannot be the same as an N parameter specified on an RJPLINE 
or RJPWS statement. 

T=termtype: Specify SS60 for System/S6 MSRJE. 

B=bufsiz: Indicates the terminal buffer size in bytes. The value specified here 
must match the value specified for the prompt Buffer length on display 11.0 during 
line member configuration at the System/S6. 

Default: 400 

C=(R,S): Indicates the t>pe of console support for this work station. If the C 
parameter is specified, a CONSOLE statement should be specified also. 

R: Applies to programmable terminals only. This subparameter indicates 
the presence of a real console. 

S: Applies to both programmable and nonprogrammable terminals. This 
subparameter specifies that regardless of any real console attached to this 
work station, the printer designated as prl is to be used as a simulated 
console output device. 

If S is specified for a programmable terminal that has a real console, that 
console can still be used to enter console commands. However, all console 
output will be directed to the printer. 

Specify C=R for System/36. 

Default: R 

F=NTRS: Specifies that the terminal transparency feature is not present on this 
terminal. If you responded Y (yes) to the prompt Transparency? on display 37.0 
during MSRJE subsystem member configuration at System/36, do not specify 
F=NTRS. 


Default: Transparency is assumed. 
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PR=nn: Indicates the number of remote printers associated with this work station. 
The value range for nn is 0 through 7. 

The value specified here should not be greater than the value entered in response to 
the prompt Maximum number of printers on display 36.0 during subsystem 
configuration at System/36. 

Default: 0 

PRW=recsize: Indicates the maximum print record size for the remote printer. 
Specify 198 only if you are using a forms control table entry with a printwheel ID 
which has a CPI= 15, or if you are using a print image of CPI= 15 when using a 
printer which supports a CPI=15. Specify 132 if you are not using a printwheel ID 
which has a CPI= 15. 

Default: 132 

PU=nn: Indicates the number of remote punches associated with this work station. 
The value range for nn is 0 through 7. 

The value specified here should not be greater than the value entered in response to 
the prompt Maximum number of punches on display 36.0 during subsystem 
configuration at System/36. 

Default: 0 

PUW =recsize: Indicates the maximum punch card record size for the remote 
punch device. 

The value specified here (1 through 4096) should be 80 for System/36. The 
destination of punch and print output received by MSRJE at System/3 6 is 
controlled by a forms control table, as generated using the forms control table 
utility (see Chapter 5 for a description of forms control tables). 

Default: 80 

RD=nn: Indicates the maximum number of readers at this work station. The value 
range for nn is 1 through 7. 

The value specified here should be at least as large as the value entered in response 
to the prompt Maximum number of host readers on display 37.0 during MSRJE 
subsystem member configuration at System/36. 

Default: 0 
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P=password: Specifies the 1 through 8 alphameric character password of the 
terminal. The password must be used by any work station trying to sign on to 
JES3. 

If a password is specified, it must match the value specified for the password! 
operand of the DATA parameter for the host signon specified on display 35.0 
during MSRJE subsystem member configuration. 

Default: 8 blanks. 

CS=(Y,B»N): Y indicates that equal character compression only is requested for 
this terminal. B indicates that blank compression only is requested for this 
terminal. N indicates that no compression is requested. 

Specify N for System/36. 
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RES Host System Generation 


The creation of a VS 1 system that supports BSC remote work stations requires two 
steps: 

• A two-stage VSl system generation with the options required to make the 
RTAM modules available in the VSl system for the next step. 

• A two-stage RTAM generation. This step assembles the desired RTAM 
facilities and link edits them into the VSl system. 

For a complete description of RES generation, see the OS/VSl RES System 
Programmer's Guide, 


VSl System Generation Requirements 

As part of a complete VSl system generation, specify OPTIONS=REMOTE in the 
SCHEDULR macroinstruction to condition VSl for the subsequent generation of 
RTAM. This causes the system to copy the necessary RTAM modules from the 
distribution libraries into the VSl system libraries. 

All BSC unit control blocks that describe the BSC line should be generated at this 
time since the communications controller uses those addresses. 

Account Facility modules and RES modules are unconditionally copied during VSl 
generation. 


RTAM Generation 


RTAM generation is a two-stage process that must be performed whenever a new 
VSl release is installed. 


Stsige 1 


Stage 1 is an assembly for which input consists of the following installation coded 
macroinstructions: 

LINE: This is step 1 of stage 1. Specify one LINE macroinstruction for each BSC 
communication line. All LINE macroinstructions must appear first in the macro 
input, and they must be in ascending BSC line number sequence; that is, the first 
LINE macroinstruction must have the number 1, the second, number 2, and so on. 

LINEID=n: Specifies the number of this BSC line. The number must be an 
integer in the range 1 through 200. The LINEID of the first (or only) LINE 
macroinstruction must be 1, and every succeeding LINEID must be 1 greater 
than the LINEID preceding it. 

LDESCR=(type,code): Specifies the type of BSC line and the code to be 
transmitted. 
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For type, specify either of the following values: 

• 0 for half duplex; 1200 through 9600 bits-per-second 

• 1 for duplex; 1200 through 9600 bits-per-second 
For code, specify either of the following: 

• 0 for EBCDIC; no transparency 

• 1 for EBCDIC; transparency 

AUTOLOG=YES/NO: If you want the remote terminal to be automatically 
logged off if this BSC line goes down (intervention is required), specify 
AUTOLOG=YES. After the system restarts the line, you may logon again. If 
you do not want automatic logoff, specify or default to AUTOLOG=NO. The 
work station remains logged on until a LOGOFF command is entered. 

LEASED=YES/NO: Specifies whether the line being defined is switched 
(LEASED=NO) or nonswitched (LEASED=YES). 

TERMINAL: This is a continuation of step 1 of stage 1. You must include the 
TERMINAL macroinstruction to associate an identification number with a work 
station and to specify the terminal device characteristics of the work stations. 
Specify at least one TERMINAL macro for each work station. The first 
TERMINAL macroinstruction must immediately follow the last LINE 
macroinstruction. 

The following parameters define the terminal to RTAM. 

TERMID=termid: Specifies the terminal number for this work station. 

TDESCR=(w,t,d,f): Defines the characteristics of the remote work station. The 
parameters are: 

w maximum print width, specify 3 (132 characters), 

or specify 5 (150 characters) if you are using a forms control table 
entry with CPI=15 or a print image which has a CPI=15 when using 
a printer which supports a CPI of 15 
t terminal type, specify 4 (360/25 and up, including System/370) 
d interface type, specify 4 (programmable interface) 
f console support/transparency, specify 2 (console, no transparency) 
or 3 (console, transparency) 

LNUM=n: Specifies the number of the BSC line with which this work station is 
to be associated. 

RDRS=rd: Specifies the number of readers to be used at this work station. If 
this operand is omitted, one reader is assumed. The range of rd is 1 through 7. 

The value specified here must at least as large as the value specified for the 
prompt Maximum number of host readers on display 37.0 during MSRJE 
subsystem member configuration at System/36. 


7-28 Multiple Session Remote Job Entry Guide 



PTRS=pr: Specifies the number of printers at this work station. If this operand 
is omitted, one printer is assumed. The range of pr is 0 through 7. 

The value specified here must not be greater than the value specified for the 
prompt Maximum number of printers on display 36.0 during MSRJE subsystem 
member configuration at System/36. 

PCHS=pu: Specifies whether a punch is at this work station. If this operand is 
omitted, one punch is assumed. The range of pu is 0 through 7. 

The value specified here must not be greater than the value specified for the 
prompt Maximum number of punches on display 36.0 during MSRJE subsystem 
member configuration at System/36. 

CNMSGNO=wtonum: Specifies the maximum number of WTO(R) buffers to 
be available for sending console messages to this work station. 

TIMEOUT=n: Specifies the length of time, in minutes, that RTAM will handle 
timeouts from a work station defined as AUTOLOG=YES. 0 minutes indicates 
infinity. 

CONPR=value: Specifies the printer to be used for console output if console 
support is not specified and more than one printer is specified. The number can 
be from 1 to the number of printers specified. 

Default: CONPR=l. 

RTAM Macro: This is step 2 of stage 1. The RTAM macroinstruction determines 
the internal characteristics of RTAM. 

TPBUF=n: Specifies the number of teleprocessing buffers required for BSC 
work stations. If this operand is omitted, n is assumed to be the same as the 
number of communications lines that have been defined by LINE 
macroinstructions. It is recommended that the following formula be used to 
determine the number of buffers that should be specified: 

n = X + y 

where x is the total number of lines defined for RTAM usage, and y is the total 
number of BSC CPU (central processing unit) work stations defined for RTAM 
usage, System/36 is a BSC CPU work station. 

TPBFSIZ=size: Specifies the size of each telecommunications buffer. The 
value entered here must equal the value entered for the prompt Buffer length on 
display 11.0 during line member configuration at System/36. 

Default: 344 

USASCII=YES/NO: If USASCII code has been specified for a BSC line, 
specify this operand as USASCII=YES; otherwise, the default (NO) applies. 
Specify NO for System/36. 
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TPREAD=readn: Specifies the total number of readers associated with the 
maximum number of work stations that can be logged on at one time. You can 
find this value by adding up the number of readers for all work stations that will 
be logged on at the same time. When a work station logs on, RTAM allocates 
resources for all job input readers (and also printers and punches). Therefore, if 
you specify too small a value for readn, a user might not be able to log on 
because of insufficient resources. 

TPPRINT=piintn: Specifies the maximum number of concurrent print 
operations. As recommended for TPREAD, you should specify a value for 
TPPRINT that is at least equal to the total number of printers at work stations 
allowed to log on at one time. You can find this value by adding up the number 
of printers for all work stations that will be logged on at the same time. 
Resources are allocated as discussed for TPREAD. 

TPPUNCH=punchn: Specifies the maximum number of concurrent punch 
operations. As recommended for TPREAD and TPPRINT, you should specify a 
value for TPPUNCH that is at least equal to the total number of punches at 
work stations allowed to log on at one time. You can find this value by adding 
up the number of punches for all work stations that will be logged on at the 
same time. Resources are allocated as discussed for TPREAD. 

MLBFSIZ=size: Specifies the size of the MULTILEAVING buffers, which are 
used by CPU work stations. 

MXINTBR=mxintbr: Specifies the maximum size of any single interface buffer 
pool. It is recommended that you specify a value at least twice as large as 
TPBFSIZ to allow room for compressed records to be expanded. 

With these macroinstructions, you provide the specifications that meet your 
particular requirements, and define the telecommunications network to be 
supported by RTAM (Stage 1). Stage 1 output is the input for stage 2. 


Stage 2 


Stage 2 consists of the execution of the job output from stage 1 including 26 
assemblies and two link edits of the execution-time modules. 
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Example RES Generation 


Date last changed 06/15/81 
SCP level OS/VS1 - 7A 


PTF level Put - 8106 
Configuration supported 


Line 

Line 

Number 

Speed 

1 

2400 

2 

2400 

Term 

Wrk/Sta 

Number 

Type 

1 

CPU 

2 

CPU 


Line Description for BSC Lines 

LINE LINEID=1, 

LDESCR=(0,1) 

LEASED=NO, 

AUTOLOG=YES 


Line 

Line 

Line 

Type 

Cntl 

Mode 

Swd 

BSC 

HDX/TRANS 

Lsd 

BSC 

HDX/TRANS 

Line 



Cntl — 


—NOTES- 


BSC CPU work stations (console support) 
BSC CPU work stations (console support) 


BSC line number 

half duplex/1200-9600 baud/trans 

this is a switched line 

force logoff if line goes down 


Interface at half duplex 1200 through 9600 baud depending on the modem. This 
line is generated as switched. The user will be logged off if intervention is required. 


LINE LINEID=2, 

LDESCR=(0,1), 
LEASED=YES, 
AUTOLOG=YES 


BSC line number 

half duplex/1200-9600 baud/trans 

this is a leased line 

force logoff if line goes down 


Interface at half duplex 1200 through 9600 baud depending on the modem. This 
line is generated as a leased (nonswitched) line. The user will be logged off if 
intervention is required. 
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Terminal Description for CPU-Type Work Stations 


TERMINAL TERMID=1, 

TDESCR=(3,4,4,3) , 
PTRS=1, 

PCHS=1, 

RDRS=1, 

CNMSGN0=5, 
TIME0UT=2, 

C0NPR=1, 

TERMINAL TERMID=2, 

TDESCR=(3,4,4,3), 
PTRS=1, 

PCHS=1, 

RDRS=1, 

CNMSGN0=5, 

CONPR=1, 


Work station terminal number 
Work station attributes 
Number of printers/work stations 
Number of punches/work stations 
Number of readers/work stations 
Number of write to operator buffers 
Restart line after 2 minutes if errors 
Use printer if no console support 
Work station terminal number 
Work station attributes 
Number of printers/work stations 
Number of punches/work stations 
Number of readers/work stations 
Number of write to operator buffers 
Use printer if no console support 


RTAM Description For RES System Generation 


RTAM TPBUF=28, 

TPBFSIZ=512, 

USASCII=NO, 

TPREAD=6, 

TPPRINT=6, 

TPPUNCH=6, 

MLBFSIZ=512, 

WAITIME=3, 

MXINTBR=1024, 

MSGFCTR=25, 

STBUFN0=48, 

RMTOBJ=SYS1.RTAMOBJ, 
HALFGEN=NO 


Number of BSC teleprocessing buffers 

Size of BSC teleprocessing buffers 

No USASCII for BSC 

Total number of readers 

Total number of printers 

Total number of punches 

CPU work stations buffer size 

Wait time for non-CPU BSC work stations 

Single interface buffer size 

Write to operator increase factor 

Number of subtask buffers 

Object library for RES generation 

No halfgen 
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3705 NCP/PEP Generation 


The generation procedure for preparing a Network Control Program includes: 

• A generation language by which network configuration and program options 
are specified. 

• A library of macrodefinitions from which the specified source statements are 
expanded. 


Generation Language 

The generation language consists of macroinstructions that fall into four categories 
according to the type of parameters they define. The types of macros are: 

• System macros 

• Configuration macros 

• Block handling macros 

• A generation delimiter macro 


System Macros 


The system macros provide information pertaining to hardware features with which 
the communications controller is equipped, certain network control program 
options, and program generation information such as data set names. 
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Configuration Macros 


The configuration macros provide the information necessary to construct the 
control tables needed by the network control program. These tables are used to 
control the flow of data between the 3705 and remote stations or other 3705s and 
the host system processor. 

One group of these macros defines the characteristics of these elements in the 
network: 

• Line groups 

• Communications lines 

• Cluster controllers 

• Terminals 

• Components of terminals 

A macro is coded for each element in the network. The macros must be arranged 
in a specific order to associate a particular communications line with a particular 
line group, a particular station or a particular SNA physical unit. The rest of the 
configuration macros provide the following types of information: 

• Information needed for data transfer between the communications access 
method and the network control program. 

• Information describing the communications scanner(s) installed in the 3705. 

• Definition of the remaining control tables necessary to control the network. 


Block Handling Macros 


The block handling macros apply to messages transmitted over binary synchronous 
communications lines. 


Generation Delimiter Macro 


The generation delimiter macro ends the program generation input stream. 

When the programmer has coded the generation macros that describe the network 
to be controlled, he generates the control program using the generation procedure. 
The procedure is executed as a series of jobs in the host processor. 
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Example 3705 PEP Generation 


PEP GENERATION FOR 3705-11 
Date last changed 03/09/82 
NCP level (NCP REL3) 

PTF level PUT - 8201 
Configuration supported 


UCB 

3705 



LINE 

LINE 

TERM 

SUBCHAN 

LINE ADDR 

USE 

SPEED 

CNTL 

NAME 

USAGE 

034 

022 

EP/LSD 

2400 

BSC 

LSBSC1 

RES/RTAM 

046 

0A1 

EP/SW 

2400 

BSC 

SWBSC1 

RES/RTAM 

046 

0A1 

EP/SW 

2400 

BSC 

SWBSC1 

RES/RTAM 


The following shows an example of what you would write for a nonswitched line. 


LSGRP1 GROUP DIALING, 

LNCTL=BSC, 

BUFSIZE=32, 

CODE=EBCDIC, 

TADDR=NONE, 

MODEM=OPTION2, 

FEATURE=(NODUALCD), 

INTPRI=1, 

CHNPRI=NORMAL, 

DATARATE=HIGH, 

QUIET=N0, 

DISABLE=NO, 

PAD=YES, 

TYPE=EP 


Group macrodefinition 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 


LSBC1 LINE ADDRESS^(022,34-0), Line macrodefinition 

SPEED=2400, 

CLOCKING=EXT, 

DUPLEX=HALF, 

TERM=SYS3, 

CU=2701, 

USE=EP, 


The following shows an example of what you would write for a switched line. 


SWGRP1 GROUP DIAL=YES, 

LNCTL=BSC, 
CODE=EBCDIC, 
MODEM=OPTION2, 
FEATURE^(NODUALCD), 
INTPRI=1, 
CHNPRI=NORMAL, 
DATARATE=HIGH, 
RING=NO, 

QUIET=NO, 

DISABLE=NO, 

PAD=YES, 

TYPE=PEP 


Group macrodefinition 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 


SWBSC1 LINE ADDRESS=(0A1,46-0), Line macrodefinition 

SPEED=2400, 

CLOCKING=EXT, 

DUPLEX=HALF, 

TERM=SYS3, 

CU=2701, 

USE=EP, 

RETRIES==(5,4,3) , 
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RSCS Host System Generation 


There are two different RSCS VM/370 programs for use with remote work 
stations: the RSCS component of VM/370 and the RSCS networking program 
product. The two look the same to the work station; however, the method for 
defining the work station at the host system is different for each. In this section, 
the RSCS component of VM/370 is referred to as RSCS component, and the 
RSCS networking program product is referred to as RSCS networking. 

For complete information on VM/370 RSCS generation, see the IBM Virtual 
Machine Facility/370: System Programmers Guide. 

Note: Print lines longer than 132 characters are not supported unless you are using a 
forms control table entry which specifies a CPI=15, or a print image which 
has CPI=15 supported when you are using a printer which supports CPI=15. 

Also, Forms Control Block Images are not supported by MSRJE. 

Defining Work Stations to RSCS 

To use a work station with RSCS, the work station’s name must be defined to 
RSCS. To define the name, an entry must be made in either the AXSLINK COPY 
file for RSCS component or in the RSCS directory for RSCS networking. A work 
station can also be dynamically defined. 

AXSLINK COPY FOe (RSCS Component) 

The AXSLINK COPY file contains a record of all possible paths for transmission 
between the RSCS virtual machine and all the single, uniquely defined, remote 
work stations. 

GENLINK Macro: The GENLINK macro defines the attributes of the link to the 
RSCS virtual machine and is similar to the LINK command in RSCS networking. 

The following parameters of the GENLINK macro define the transmission path. 

ID=Linkid: Specifies, in 1 through 8 alphameric characters, the link identifier for 
the work station. 

TYPE=DMTSML: Specifies that the spool MULTILEAVING (SML) line driver 
is to be used on the data link. If DMTSML is not specified, it must be specified 
when the link is activated using the START command. 

Default: Undefined. 

CLASS=c: Specifies the class of files that can be transmitted to the remote work 
station. One to four VM/370 spool classes can be specified and are in the range A 
through Z and 0 through 9. Files are transmitted in class order, left to right. 

Default: *, all classes can be transmitted. 
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KEEP=holdslot: Specifies the number of RSCS virtual machine storage file tag slots 
to be reserved for exclusive use by the link. Specify any decimal number from 0 
through 16. 

Default: 2 

LINE=vaddr: Specifies the RSCS virtual machine device address of a permanent 
telecommunications line port to be used for processing files on the link. 

Default: Undefined. 

TASK=taskname: Specifies a task name for use by the line driver program. From 
one to four alphameric names can be specified. 

Default: Undefined. 

RSCS Directory (RSCS Networking) 

Each work station’s operation must be specified using local (to the host system) 
definitions and options. A directory file with a file name of RSCS and a file type of 
direct is built for the use of RSCS networking. 

The following statements are used to build the entries in the file. Note that RSCS 
networking also generates 16 null entries in the file so that work stations can be 
dynamically defined. 

LINK Control Statement: Defines the attributes of a single RSCS link. Link 
attributes can be later changed using the START command parameters. The 
following parameters of the LINK statement define the link: 

linkid: Specifies, in 1 through 8 alphameric characters, the link identifier for the 
work station. 

DMTSML: Specifies the line driver to be used for communications on the link. 
If DMTSML is not specified, it must be specified in the START command. 

Default: Undefined. 

port: Specifies the RSCS virtual machine device address of a permanent 
telecommunications port to be used for communications on the link being 
defined. Valid RSCS addresses are hexadecimal characters from 02 through 
6FF. If port is not defined, it must be specified on the START command. 

Default: Undefined. 

zone: Specifies the number of time zone boundaries between the work station 
and Greenwich time to the east. The international date line is included as a time 
zone boundary. Valid entries are 0 to 24, decimal. 

Default: 0 
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task: Specifies a task name for use by the line driver program. Each RSCS task 
must have a unique name while it is active. One to four task names can be 
specified. 

Default: The first 4 characters of the linkid. 

class: Specifies the class of files that can be transmitted to the remote work 
station. One to four VM/370 spool classes can be specified and are in the range 
A through Z and 0 through 9. Files are transmitted in class order, left to right. 

Default: *, all classes can be transmitted. 

keep: Specifies the number of RSCS virtual machine storage file tag slots to be 
reserved for exclusive use by the link. Specify any decimal number from 0 to 16. 

Default: 2 

FARM Control Statement: Defines a default parameter string of arbitrary text 
information made available to the line driver when the link is activated by the 
START command. The string specified can be overridden by the Farm operand of 
the START command. 

linkid: Specifies, in 1 through 8 alphameric characters, the identifier of the 
previously defined port on which the work station is connected, and to which the 
parameter string applies. 

Mm: Specifies an identification number assigned to the work station by the 
host. Valid entries are 00 through 99, decimal. The value specified here and the 
value specified for the REMOTEnn parameter of the /*SIGNON on display 
35.0 during MSRJE subsystem member configuration must match. 


Initiating the Connection 


Starting an SML Line Driver (DMTSML) 

Before a work station can sign on to SML, the appropriate task for that link must 
have been started during system start up or by the System/370 RSCS operator. 

The START command is used to start the appropriate task, and has the following 
parameters: 

linkid: Specifies, in 1 through 8 alphameric characters, the link identifier for the 
work station. 

TYFE DMTSML: Specifies the name of the line driver to be used. 

LINE vaddr: Specifies the RSCS virtual machine address of the communications 
line port (specified only if the port to be used is different than the one specified 
for the linkid). 
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Parm: A keyword that specifies that one or more parameters as follows: 

Mra: Specifies an identification number assigned to the work station by the 
host. Valid entries are 00 through 99, decimal. The value specified here and 
the value specified for the REMOTEnn parameter of the /*SIGNON on 
display 35.0 during MSRJE subsystem member configuration must match. 

Bimnn: Specifies the size, in bytes, of each communications buffer. The 
maximum value is 1017. If a password entry is made, this value must be 
specified. The value specified here must match the entry made for the prompt 
Buffer length on display 11.0 during line member configuration at the 
System/36. 

Default: 400 

password: Specifies the 1 through 8 alphameric character password that the 
terminal must send to sign on to the link. If a password is entered here, the 
same entry must be made for the password parameter of the /*SIGNON 
specified on display 35.0 during MSRJE subsystem member configuration at 
System/36. 

Default: No password. 

Note: If a password is specified, you must also specify a value for the Bnnnn 
parameter, 

TASK=name: Specifies a task name for use by the line driver program. One to 
four alphanumeric names can be specified. 

Default: Undefined. 

CLASS=C: Specifies the class of files that can be transmitted to the remote 
work station. One to four VM/370 spool classes can be specified and are in the 
range A through Z and 0 through 9. Files are transmitted in class order, left to 
right. 

Default: The class defined for the link’s link table entry. 

Note: The maximum print length supported is 198. 
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Chapter 8. Defining MSRJE to an SNA Host System 


This chapter contains information that is needed by the host system programmer 
to properly configure a communications network that includes System/3 6 
running MSRJE. The information given here is intended to point out those 
items that are needed to support MSRJE; it is not intended to be a reference 
document for configuring a host system. Changes to the parameters and their 
default values sometimes occur between releases. Therefore, the information 
given here may not exactly reflect the host subsystem release with which you are 
operating. 


System Components 

SNA MSRJE enables the System/36 to submit jobs to an IBM host processor 
using SDLC or X.25 link protocol. The System/3 6 serves as an RJE work 
station in the network, 

SNA MSRJE supports communications with the following host subsystems using 
Advanced Communications Function/Virtual Telecommunications Access 
Method (ACF/VTAM) Release 2 or 3, and Network Control Program/Virtual 
Storage (NCP/VS) Release 2 or 3: 

. OS/VS2 Job Entry Subsystem 2 (JES2) 

• OS/VS2 Job Entry Subsystem 3 (JES3) 

• OS/VSl Remote Entry Services (RES) 

. VSE/POWER 

SNA MSRJE requires the following components on the host system: 

• 270x or 37xx Communications Controller and ACF/NCP 

• Advanced Communications Function/Virtual Telecommunications Access 
Method (ACF/VTAM) 

. An operating system (OS/VSl, OS/VS2 (MVS), or DOS/VSE) 
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The relationship of these components to each other is shown in Figure 8-1. 



Job Entry Subsystem 2 


Job Entry Subsystem 3 


Remote Entry Services 


VSE/POWER 


S7909005-0 


Figure 8-1. MSRJE to SNA Host System Relationships 

For the 4300 system with ICA, VTAME will replace ACF VTAM. 
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Communications Controller and the NCP 


The IBM 3 7XX Communications Controllers provide communications control by 
means of the Network Control Program (NCP). A communications controller 
and its NCP support a variety of remote terminals attached to the controller. 

The NCP is generated from a series of user-specified macroinstructions. An 
NCP can be generated to handle lines in either network control mode, or 
emulation mode, or both. An NCP that is generated with both kinds of 
functions is called an NCP with the Partitioned Emulation Programming (PEP) 
extension. 

Remote Terminal Access Method (RTAM), JES2, and JES3 use the facilities of 
the NCP to control lines and devices attached to the controllers, to transmit and 
receive data, and to perform error recovery. Virtual Telecommunications Access 
Methods (VTAM) executes macroinstructions to direct the acquisition, reading, 
writing and checking of data from the terminals to which it is connected. 

Note: If you plan to use an X,25 line in connecting your system to an IBM 3 7xx 
Communications Controller, you will need the Network Packet Switching 
Interface Program Product. 

For additional information on the Communications Controllers and the NCP, 
see one of the following manuals: 

• Introduction to the IBM 3704 and 3705 Communications Controllers 

• 3725 Model 1 Communication Controller, Introduction 

• 3725 Model 2 Communication Controller, Introduction 
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Communications Access Methods 


RTAM 


RTAM is a communications access method used by SNA operations. All work 
stations, communications line, and transmission code dependencies are resolved 
by RTAM. 

RTAM is started on a communications line basis rather than on a work station 
basis. To initiate processing, the central operator issues a START RTAM 
command, which, in turn, starts one or more communications lines. Additional 
lines can be started later by entering a MODIFY command specifying lines that 
were previously allocated to RTAM. Any work station compatible with the line 
adapter and data set (for switched lines) attached to the line can establish 
connection with RES through a LOGON procedure that identifies the particular 
work stations or work station user. 


JES2 


The Remote Job Entry (RJE) facility of JES2 allows remote work stations to 
use the Job Entry Subsystem. To initiate processing, the system operator starts 
one or more lines by entering the $S Start command. Any work station 
compatible with the line adapter and data set (for switched lines) attached to the 
line can establish connection with JES2 through a SIGNON procedure that 
identifies the particular work station or work station user. JES2 uses RTAM to 
provide an interface between JES2 and the remote terminal. 


JES3 


JES3 uses RTAM to provide an interface between JES3 and the remote 
terminal. RTAM provides blocking/deblocking, compression/decompression, 
and synchronization with the remote terminal. To initiate processing, the system 
operator enters a *START LINE command. Any work station compatible with 
the line adapter and data set (for switched lines) attached to the line can 
establish connection with JES3 through a SIGNON procedure that identifies the 
work station or work station user. 


8“4 Multiple Session Remote Job Entry Guide 



JES2 Host System Generation for SNA MSRJE 


When JES2 is started, a series of initialization parameters are processed to 
determine the configuration options to be used. Initialization parameters that 
are required for MSRJE can be characterized as: (1) system-wide initialization 
values and (2) remote work station definitions. For a complete description of the 
JES2 generation, see the manual OS/VS 2 MVS System Programming Library: 
Initialization and Tuning. 

JES2 System-Wide Initialization Parameters 

The following JES2 system-wide initialization parameters are used in defining 
System/36 MSRJE work stations. 

LOGONn: The LOGONn parameter identifies JES2 as an application program 
to VTAM. 

APPLID =cccccccc: Specifies, in 1 through 8 alphameric characters, the name 
that the host has assigned to JES2. If specified the value must match the name 
field of the VTAM APPL definition for JES2. 

Default: JES2. 

PASSWORD=cccccccc: Specifies, in 1 through 8 alphameric characters, the 
password presented to VTAM. If specified, the password must match the 
PRTCT parameter of the VTAM APPL application definition statement. 

Default: No password. 
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&MAXSESS (Maximum Number of VTAM Sessions): The &MAXSESS 
parameter specifies the maximum number of VTAM sessions (nnnn) that can be 
active at any one time. The valid range of values is between 1 and 9999. 
Terminals attempting to log on when nnnn sessions are already active are not 
allowed to log on. 

Default: The number of LINEnnn initialization statements specifying the 
UNIT=SNA keyword. 

&NUMBUF (JES2 I/O Buffer Count): The &NUMBUF parameter specifies the 
number (15 through 2000) of I/O buffers to be included in the JES2 load 
module. The value specified should reflect the total number of buffers required 
for proper operation of JES2. 

Because all JES2 buffers are maintained in a dynamic pool until required by an 
active function, the appropriate number of buffers should be based on the 
predicted number of concurrent functions required at the installation. Refer to 
the OS/VS 2 MVS System Programming Library: Initialization and Tuning for 
more information. 

&NUMCMBS (Number of JES2 Console Message Buffers): The &NUMCMBS 
parameter specifies the number (3 through 999) of console message buffers to 
be provided for JES2. The number of buffers specified should be sufficient to 
accommodate all outstanding operator requests and still allow message 
processing to continue. 

During periods of high console activity, when no message buffers are available, 
certain noncritical JES2 messages are discarded to avoid delaying the associated 
process. These noncritical messages include certain RJE-oriented messages, and 
certain 1/O error messages on JES2-controlled devices. 

Default: 15 
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&NUMJOES=iiiiim (Number of Job Output Elements): Specifies the number of 
job output elements to be generated. 

One job output element is required for each: 

• Unique SYSOUT class that appears in a job that is queued for output. 

• Active printer or punch. 

• Interrupted or restarted job that is not currently active on printer or punch. 

• Unique combination of forms ID, USCID, and FCB ID for all jobs currently 
queued for output. 

• Job that was interrupted by a system failure while being printed or punched 
and has not yet been warm started on an output device. 

Specifying too small a value results in jobs waiting for in-storage queuing before 
completing active print or punch work. For performance, you should specify a 
number slightly greater than the total of the above elements. 

Default: 10 times the total number of local and remote printers and punches. 

&NUMLNES (Number of Teleprocessing Lines): Specifies the maximum number 
of LINEnnn initialization parameters that can be specified. This value includes 
the number of lines defined either as BSC MULTILEAVING lines or as logical 
lines for SNA. 

Default: 0 

&NUMRJE=nnn (Number of Remote Terminal Definitions): Specifies the 
number (0 through 255) of remote terminal definitions (RMTnnn). This value 
should correspond to the highest number used as an RMTnnn initialization 
parameter. 

Default: The value specified for the &NUMLNES parameter. 

&NUMTPBF=nnnn (Number of JES2 Teleprocessing Buffers): Specifies the 
number (0 through 2000) of teleprocessing buffers to be generated for RJE and 
NJE (network job entry) by JES2. This value includes the buffers required for 
remote terminals supported as logical units. 

The minimum requirement for SNA is three buffers plus two buffers for every 
SNA RJE terminal. All other signed-on terminals require at least one buffer 
each. 

Default: 2 times the value of &NUMLNES. 
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&PRTRANS=YES/NO (Print Line Translation Option): Specifies whether to 
translate lines of print not directed to 3211 printers. If the default value is used, 
each line to be printed by a local 1403 or any remote printer is first translated. 
Translation changes: 

• Lowercase letters to uppercase. 

• Characters that are invalid on a PN train to blanks. If any print train is to be 
used on a JES2“Controlled local 1403 or on a remote printer that has 
characters not equivalent to those on a PN, NO must be specified. 

Default: YES. 

&SPOLMSG=mm (Remote Terminal Spool Message Record Count): Specifies 
the number (0 through 254) of physical records to be reserved for operator 
messages and JES2 messages for each JES2 remote terminal. 

Default: (4096/&BUFSIZE) x 6 if &NUMLINES is not 0; 0 if &NUMLNES 
is 0. 

&TPBFSIZ=nnnn (Teleprocessing Buffer Size): Specifies the largest 
telecommunications buffer size in bytes (128 through 3976) required for any 
remote work station. 

This value is increased, if necessary, to the largest BUFSIZE value specified for 
an SNA remote terminal. 

Default: 400 

&TPIDCT=nnn (Remote Printer Separator Page Line Count): Specifies the 
number (0 through 255) of print lines that are to appear on each JES2 job 
output separator page for remote terminal printers. If the specification is 30 or 
greater, the first 29 lines are used to produce a block-lettered job name, job 
number, and SYSOUT class. 

Default: 6 

&WAITIME=nn (Remote Terminal Function Interval): Specifies the length of 
time in seconds (1 through 30) JES2 waits after processing an input stream or 
output stream to allow entry of commands or jobs by the RJE operator. 

Default: 1 
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Remote Work Station Definitions 


JES2 remote work station definitions consist of a series of LINEnnn, RMTnnn, 
Rnnn.PRm, Rnnn.PUm, and Rnnn.RDm parameters. The following are used in 
defining System/36 MSRJE work stations: 


LINEnnn (Line Definition) 


The LINEnnn parameter specifies the characteristics of one teleprocessing line 
or logical line to be used during remote job entry. This parameter should be 
specified for each teleprocessing line. Lines are numbered consecutively 
(LINEl to LINE255) for the number of lines specified by the &NUMLNES 
parameter. 

The following LINEnnn subparameters are used in defining SNA work stations. 

PASSWORD=cccccccc: Specifies a 1 through 8 alphameric character security 
password to be used by this work station when it logs on. 

The entry made here must match the entry made for the passwordl entry of the 
DATA parameter for the host signon specified on display 35.0 during MSRJE 
subsystem member configuration at System/36. 

Default: 8 blanks. 

UNIT—SNA: Specifies that this LINEnnn parameter is for SNA use. 

RMTnim (Remote Work Station Definition) 

The RMTnnn parameter specifies the characteristics of one remote work station. 
One RMTnnn parameter is required for each work station. 

nnn specifies an identification number for the work station. Work stations are 
numbered consecutively from 1 through 255. Do not use leading O’s for nnn. 
The highest value specified for nnn must match the value specified for 
&NUMRJE. 

The following subparameters of RMTnnn are used in defining SNA work 
stations. 

LUTYPEl: Must be specified for System/36 MSRJE. 

BUFSIZE=iiim: Specify 256. This is the largest request unit (RU) that can be 
sent to or received from this work station. 

Default: 256 
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COMP/NOCOMP: COMP specifies that this terminal has the 
compression/expansion feature. All SNA terminals have this feature; but the 
default value, NOCOMP, can be used. 

Default: NOCOMP, which specifies that this terminal does not have the 
compression/expansion feature. 

Specify NOCOMP for better line usage. 

CONSOLE/NOCON: CONSOLE specifies that this SNA remote terminal has an 
operator console. Specify CONSOLE for System/36. 

Default: NOCON, which specifies that the remote terminal has no operator 
console. 

CMPCT/NOCMPCT: Specifies whether compaction is used at this work station. 
Specify NOCMPCT since System/36 does not support compaction. 

Default: NOCMPCT. 

DISCINTV=nnnn: Specifies the time interval (in seconds) after which JES2 
terminates the session if there is no text transmission in either direction. 
DISCINTV applies to both switched and nonswitched lines. It is recommended 
that 0 be specified (default) for nonswitched lines. This value indicates that the 
session is not to be terminated and the work station is not to be disconnected. 

Default: 0 

FIXED/VARIABLE: Specify VARIABLE (specifies variable-length data records). 
Default: VARIABLE. 

LUNAME=cccccccc: Specifies the logical unit name of this remote work station. 
LUNAME is not required and is used only in conjunction with automatic logon. 

If specified, this name must be the same as the name defined to VTAM at system 
initialization. 

NUMPR=n: Specifies the number of printers at this remote terminal. Valid 
entries are 0 through 7. The maximum value is 6 if CONSOLE is specified, or 7 if 
CONSOLE is not specified. 

The value specified here should not be greater than the value specified for the 
prompt Maximum number of printers on display 36.0 during MSRJE subsystem 
member configuration at System/36. 

Note: The total number of printers and punches must not exceed 8. 

Default: 1 
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NUMPU=n: Specifies the number of punch devices at this remote terminal. 
Valid entries are 0 through 7. 

The value specified here should not be greater than the value specified for the 
prompt Maximum number of punches on display 36.0 during MSRJE subsystem 
member configuration at System/36. 

Note: The total number of printers and punches must not exceed 8. 

Default: 0 

NUMRD=n: Specifies the number or readers at this remote terminal. Valid 
entries are 0 through 7. 

The value specified here should be at least as large as the value specified for the 
prompt Maximum number of host readers on display 37.0 during MSRJE 
subsystem member configuration at System/36. 

Default: 1 

PASSWORD=cccccccc: Specifies a security password (1 through 9 alphameric 
characters) to prevent unauthorized terminals from using this remote terminal’s 
resources. 

The entry made here must match the entry made for the password! operand of 
the DATA parameter for the host signon specified on display 35.0 during 
MSRJE subsystem member configuration at System/36. 

Default: No password. 

ROUTECDE=nnn: Specifies the route code to be assigned to this terminal and 
its associated printers, punches, and readers. The value of nnn may be any 
number from 1 through the value of &NUMRJE. 

Default: If a route code is not specified, JES2 assigns the number of this 
terminal (RMTnnn) as its route code. 
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SETUPHDR/SETUPMSG: SETUPHDR specifies that a function management 
header, containing setup information, is constructed and sent to the remote work 
station. The remote work station is responsible for processing the header and 
generating any required messages. SETUPHDR allows spooling of data and 
generation of multiple copies of a data set (from the original sent by JES2) at a 
remote work station. 

Specify SETUPHDR for the System/36. 

Default: SETUPMSG, which specifies that JES2 is to inform the remote 
operator of any setup requirements via the $HASP190 message. Upon 
completion of setup, the operator must issue a $S command to start JES2 
transmission. 

SETUPINF/SETUPACT: SETUPINF, which should be specified for 
System/36, specifies that operator setup messages issued at the local (CPU) 
console for this remote device are to be informational messages (they do not 
require an operator action to be deleted from a display console). 

Default: SETUP ACT, which specifies that operator setup messages issued at 
the local console for this remote device are flagged as action messages (requiring 
an operator action to be deleted from a display console). 

WAITIME=nn: Specifies the length of time in seconds (1 through 30) that 
RTAM should wait at the completion of the processing of any input stream, 
printed output stream, or punched output stream to allow the operator to enter 
an input stream at this remote terminal. The value of n is greater than 0. 

Default: The value specified for the &WAITIME initialization parameter. 
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Rimn.PRm (Remote Printer Definition) 


The Rnnn.PRm parameter specifies the characteristics of one printer at a remote 
work station. 

nnn specifies the number of the work station as specified in an RMTnnn 
initialization parameter. 

m specifies the number of this printer. 

The number of printers defined using the Rnnn.PRm parameter must match the 
number of printers specified for the NUMPR subparameter of the RMTnnn 
parameter. 

The following subparameters further define the remote work station printer: 

AUTO/OPERATOR: AUTO specifies that this printer is to operate initially in 
automatic (demand) forms mode when JES2 starts processing. 

Specify AUTO for System/36. 

Default: OPERATOR which specifies that this printer is to operate initially in 
operator-controlled (forms) mode. 

The mode may be modified from the remote terminal via the JES2 $T set 
command. 

CCTL/NOCCTL: CCTL specifies that carriage control characters and SNA 
character strings (SCS) are to be placed in the output stream transmitted to this 
printer. 

Note: If NOCCTL is specified, no TRN (transparent) SCS coding (or 
compression or compaction) is performed. 

Default: CCTL. 
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CKPTLNS=iiiiiiiiii: Specifies the maximum number of lines (0 through 32767) 
in a page. The size of a logical page is also defined as the number of lines 
printed until: 

• A channel skip is encountered. 

• The line count specified by &LINECT, the /*JOBPARM control statement, 
or the JOB statement accounting field has been exceeded. 

If CKPTLNS is 0, a logical page is defined only by the preceding items. 

If the line count does not equal 0, setting CKPTLNS to a value greater than line 
count results in the line count being used as the definition of a logical page; it 
overrides CKPTLNS. 

CKPTLNS used in conjunction with CKPTPGS is used to specify the 
checkpoint interval for data sets having a line count of 0 and no channel skips. 
In most cases, specifying CKPTLNS=0 sets the most efficient checkpoint 
interval. 

Default: 0 

CKPTPGS=iiiiiinn: Specifies the number of logical pages (1 through 32767) to 
be printed before each checkpoint is taken. 

For SNA remote printers, the CKPTPGS and CKPTLNS parameters determine 
the number of logical records within an SNA chain. JES2 will not take a 
checkpoint until it receives acknowledgment that the chain was received 
successfully by the remote. The chain size is the number of logical pages 
specified by CKPTPGS. 

The larger the number you specify for this parameter, the less frequently the 
host system waits for an acknowledgment. Therefore, a larger number may 
improve performance. 

Default: 1 

CLASS=cl...cn: Specifies the output classes, in priority sequence, to be 
processed initially by this printer. You can specify any number of classes (A 
through Z and 0 through 9) up to the maximum number of classes specified by 
the &NUMCLAS parameter. 

Default: AJ (where A and J are classes assigned to this printer). 

CMPCT/NOCMPCT: Specifies whether or not this printer has compaction 
capabilities. 

Default: The CMPCT/NOCMPCT specification for the corresponding 
RMTnnn initialization parameter. 

Note: System 136 does not support compaction. 
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COMP/NOCOMP: COMP specifies this remote SNA printer has 
compression/expansion capabilities. COMP forces this remote SNA printer to 
use compression only if the corresponding remote terminal (RMTnnn) 
initialization parameter has COMP specified. NOCOMP turns off compression 
for this remote SNA printer even if the corresponding RMTnnn initialization 
parameter specifies COMP. 

Default: The COMP/NOCOMP specification for the corresponding RMTnnn 
initialization parameter. 

COMPACT=mi/0: Specifies the compaction table (nn) to be used for all 
remote printer data. The CMPCT subparameter of RMTnnn must indicate that 
compaction is supported by this printer. The value range of nn is 0 through 99. 
Specify 0 since System/36 does not support compaction. 

Default: 0 (no compaction table). 

DRAIN/START: DRAIN specifies that this printer is to be started by operator 
command. START, which should be specified for System/36, specifies that this 
printer (if it is ready) is to be started automatically when JES2 starts processing. 

Default: START. 

FORMS=cccc: Specifies the forms identifier of the forms that are assumed to 
be initially loaded in this printer (1 through 4 alphameric characters). 

Default: If no value is specified, JES2 uses the forms identifier specified by the 
&STDFORM generation parameter. 

LRECL=niin: Specifies the logical record length (nnn) of data transmitted to 
the SNA remote printer. This value must not exceed the printer width specified 
during RMT generation (by the &PRTSIZE or PRTFOTLW RMT generation 
parameters) for this terminal. LRECL may be used in place of the PR WIDTH 
subparameter when specifying record sizes destined for remote devices. The 
maximum value for LRECL is 255. 

Specify 198 only if you are using a forms control table entry with a printwheel 
ID which has a CPI=15, or if you are using a print image of CPI=15 when using 
a printer which supports a CPI=15. Specify 132 if you are not using a 
printwheel ID which has a CPI=15. 

Default: 120 

LIMIT=(in-n,iii-*): The LIMIT subparameter allows you to specify that output 
is to be selected for specific printers based upon the amount of the output (in 
records). The values m and n specify within what output size range (in records) 
a job output element (JOE) must fall to be processed by this printer. The integer 
m specifies the lower output size limit, and n specifies the upper output size 
limit. The value of m must be less than the value of n. The maximum value that 
can be explicitly assigned to n is 999999 records. If * is specified, the upper 
limit is set to the default value of n (4294767295). 

Default: m equals 0, and n equals 4294767295. 
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NOSEP/SEP: NOSEP specifies that separator pages are not to be provided 
initially between data set groups. 

Default: SEP, which specifies that separator pages are to be provided initially 
between data set groups. 

Notes: 

1. If 0 print lines were specified by the &TPIDCT parameter, separator pages will 
not be produced even if SEP is specified. 

2. If a user-written exit routine generates the separator pages, it should contain a 
SSEPPDIR macro to insure that PDIRs are sent to MSRJE. 

PRWIDTH=mm: Specifies the maximum number of characters to be printed on 
one line. 

Specify 198 only if you are using a forms control table entry with a printwheel 
ID which has a CPI=15, or if you are using a print image of CPI=15 when using 
a printer which supports a CPI=15. Specify 132 if you are not using a 
printwheel ID which has a CPI==15. 

Default: 120 

ROUTECDE=iimi: Specifies the route code (1 through 255) to be assigned to 
this printer. The route code specified may be that of any remote terminal defined 
to JES2 by means of the RMTnnn initialization parameter. 

Default: JES2 assigns the route code of the remote terminal to which the printer 
is attached. (See the description of the RMTnnn parameter in this chapter for 
more information about the route code). 
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Rimn.PUm (Remote Card Punch Definition) 


The Rnnn.PUm parameter specifies the characteristics of one punch at a remote 
work station. 

nnn specifies the number of the work station as specified in an RMTnnn 
initialization parameter. 

m specifies the number of this punch. 

The number of punches defined using the Rnnn.PRm parameter must match the 
number of punches specified for the NUMPU subparameter of the RMTnnn 
parameter. 

The following subparameters further define the remote work station card punch. 

AUTO/OPERATOR: AUTO, which should be specified for System/36, 
specifies that this punch is to operate initially in automatic (demand) forms 
mode when JES2 starts processing. 

Default: OPERATOR, which specifies that this punch is to operate initially in 
operator-controlled (forms) mode. The mode may be modified from the remote 
terminal via the JES2 $T set command. 

CCTL/NOCCTL: CCTL specifies that card separator control characters are to 
be placed in the output stream transmitted to this punch. 

Note: If NOCCTL is specified, no TRN (transparent) SCS coding (or 
compression or compaction) is performed. 

Default: CCTL. 

CKPTLNS==nmuin: Specifies the maximum number of cards (0 through 32767) 
to be punched per logical page. 

CKPTLNS is the only value used to define a logical page for punches. 

Default: 100 

CKPTPGS=nnnnn: Specifies the number of logical pages (1 through 32767) to 
be punched before each checkpoint is taken. 

For SNA remote punches, the CKPTPGS and CKPTLNS parameters determine 
the number of logical records within an SNA chain. The number of logical 
records equals CKPTLNS multiplied by CHKTPGS. JES2 will not take a 
checkpoint until it receives acknowledgment that the chain was successfully 
received by the remote. The chain size is the number of logical pages specified 
by CKPTPGS. 

Default: 1 
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CLASS=cl...cn: Specifies the output classes, in priority sequence, to be processed 
initially by this punch. You can specify any number of classes (A through Z and 0 
through 9) up to the maximum number of classes specified by the &NUMCLAS 
parameter. 

Default: BK (where B and K are classes assigned to this remote punch). 

CMPCT/NOCMPCT: Specifies whether this punch has compaction capabilities. 
Specify NOCMPCT since System/36 does not support compaction. 

Default: The CMPCT/NOCMPCT selection made for the RMTnnn parameter. 

COMP/NOCOMP: COMP specifies that this remote punch has 
compression/expansion capabilities. COMP forces the remote punch to use 
compression only if the corresponding remote terminal (RMTnnn) initialization 
parameter has COMP specified. NOCOMP turns off compression for this remote 
punch even if the corresponding RMTnnn initialization parameter specifies COMP. 

Default: The COMP/NOCOMP specification for the corresponding RMTnnn 
initialization parameter. 

COMPACT=iin/0: Specify 0 since System/36 does not support compaction. 
Default: 0 (no compaction table). 

DRAIN/START: DRAIN specifies that this punch is to be started by operator 
command. START, which should be specified for System/36, specifies that this 
punch (if it is ready) is to be started automatically when JES2 starts processing. 

Default: START. 

FORMS=cccc: Specifies the forms identifier of the cards that are assumed to be 
initially loaded in this punch. If SETUPHDR is specified, then FORMS has no 
effect. If SETUPMSG is specified, then JES2 assumes that the cards specified are 
initially loaded in the punch and does not issue a message to the operator to load 
them. 

Default: JES2 will use the identifier specified by the &STDFORM parameter. 

The &STDFORM parameter specifies an identifier, 4 alphameric characters, that is 
used as a forms ID when a forms ID is not specified. It also specifies the default 
initial setup of all printers and punches at JES2 initialization. The default is STD 
or STD., depending on which release of JES2 is installed on your system. 
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LIMIT=(m"n,ni-*): The LIMIT subparameter allows you to specify that output 
is to be selected for specific punches based upon the amount of the output (in 
records). The values m and n specify within what output size (in records) a job 
output element (JOE) must fall to be processed by this punch. The integer m 
specifies the lower output size limit and n specifies the upper output size limit. 
The value of m must be less than the value of n. The maximum value that can 
be explicitly assigned to n is 999999 records. If * is specified, the upper limit is 
set to the default value of n (4294767295). 

Default: m equals 0, and n equals 4294767295. 

LRECL=NNN: Specifies the logical record length of data transmitted to the 
SNA remote punch. For System/36, specify 80. 

Default: 80 

NOSEP/SEP: NOSEP specifies that separator cards are not to be provided 
initially between data set groups. 

Default: SEP, which specifies that separator cards are to be provided initially 
between data set groups. 

ROUTECDE=iinn: Specifies the route code (1 through 255) to be assigned to 
this punch. The route code specified may be that of any remote terminal defined 
to JES2 by means of the RMTnnn initialization parameter. 

Default: JES2 assigns the route code of the remote terminal to which the punch 
is attached. (See the description of the RMTnnn parameter in this chapter for 
more information about the route code.) 
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Rnim.RDm (Remote Card Reader Definition) 


The Rnnn.RDm parameter specifies the characteristics of one logical reader at a 
remote work station. Specify one Rnnn.RDm parameter for each reader at the 
work station. 

nnn specifies the number of a work station as specified in an RMTnnn 
parameter. 

m specifies the number of this card reader. 

The number of readers defined using the Rnnn.PRm parameter must match the 
number of readers specified for the NUMRD subparameter of the RMTnnn 
parameter. 

The following subparameters further define the remote reader: 

CLASS=c: Specifies the job class to be assigned to all jobs that are entered at 
this card reader and that do not specify a job class in the CLASS operand of 
their JOB statements. The value c can be any class A through Z and 0 
through 9. 

Default: A 

DRAIN/START; DRAIN specifies that this card reader is to be started by 
operator command. START, which should be specified for the System/36, 
specifies that this card reader is to start automatically when JES2 starts 
processing. 

Default: START. 

HOLD/NOHOLD: HOLD specifies that all jobs entered at this card reader are 
to be held after JCL conversion until they are released for execution by the 
operator. 

Default: NOHOLD which specifies that jobs entered at this card reader are to 
be queued as usual. 

MSGCLASS=c: Specifies the default message class to be assigned to jobs that 
are entered at this card reader and that do not specify a MSGCLASS operand in 
their JOB statements. The value of c can be any class A through Z and 0 
through 9. 

Default: A 


8-20 Multiple Session Remote Job Entry Guide 



PRDEST=iiiin: Specifies the printer destination for the printed output from all 
jobs that are entered at this card reader that do not have a ROUTE statement or 
DEST parameter. 

Default: The route code (ROUTECDE) specified in the RMTnnn parameter for 
this remote terminal. 

PRIOINC=nn: Specifies a number (0 through 15) to be added to the selection 
priority of each job entered at this card reader. 

Default: 0 

PRIOLIM=iin: Specifies the maximum priority level (0 through 15) that can be 
assigned to jobs entered at this card reader. 

Default: 15 

PRLCL/PRRMT: PRLCL specifies that the route code specified by PRDEST is 
that of a local printer. 

Default: PRRMT, which specifies that the route code specified by PRDEST is 
that of a remote printer. 

PUDEST=imn: Specifies the card punch destination for the punched output 
from jobs entered at this card reader that do not have a ROUTE statement or a 
DEST parameter. 

Default: The route code (ROUTECDE) specified in the RMTnnn parameter for 
this remote terminal. 

PULCL/PURMT: PULCL specifies that the route code specified by PUDEST 
is that of a local card punch. 

Default: PURMT, which specifies that the route code is that of a remote card 
punch. 

In addition to the JES2 parameters, an NCP generation for the 37xx may be 
necessary. For additional information, refer to the NCP generation information 
in this chapter. 
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JES3 Host System Generation 


The following JESS initialization statement parameters are used in defining 
System/36 MSRJE work stations. For a complete description of the 
initialization parameters, see the manual OS/VS 2 MVS System Programming 
Library: JESS. 

COMMDEFN (Communications Subsystem Interface Definition Records) 

The COMMDEFN statement identifies the optional user communications 
subsystem interface (VTAM) parameters. 

APPLID=applname: Indicates the application name as specified to VTAM in a 
VTAM generation application definition statement (APPL). This parameter is 
used in establishing the application program interface (API) at OPEN ACB 
time. 

Default: JESS 

P=password: Specifies the 1 through 8 character alphameric password which is 
used by JESS when issuing an OPEN ACB macro. This parameter must be the 
same as the password specified in the PRTCT parameter of the VTAM APPL 
application definition statement. 

Default: No password. 

LU=raiim: Specifies the total number of LU-to-LU sessions that can exist 
concurrently. 

COMPACT (Compaction Table Definition) 

The compact statement defines a compaction table to JESS. System/36 does 
not support compaction. 

CONSOLE (RJP Operator Console) 

The CONSOLE statement is required to define each SNA RJP console. This 
statement is used to assign JESS destination classes to that console. Only one 
console can be specified on each CONSOLE statement. The parameters that 
make up the CONSOLE statement are: 

JNAME=name: Specifies the name of the SNA RJP work station. The JNAME 
must match the name specified in the N parameter on a RJPWS statement. 

TYPE=RJP: Specifies that the console being defined is an RJP console. 
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DEST=destcode: Specifies one or a series of destination codes that represent 
message classes to be directed to this console. 

The following are values which may be specified for destcode. They represent 
the 96 JES3 message categories: 

ALL: Specifies that messages issued by the operator with the destination 
specified as ALL will be routed to all consoles regardless of what is specified in 
the BEST parameter of the CONSOLE statement unless DEST=NONE is 
specified. 

ERR: Console receives messages concerning equipment failure as well as JES3 
failsoft messages. 

JES: Console receives general information messages pertaining to the operation 
of the global processor. 

LOG: Console receives messages concerning active jobs, such as job started or 
job ended. 

MN: Console receives all input and output messages, except security messages, 
providing that MLOG is specified in the HARDCOPY parameter of the 
CON STD statement. This is in addition to the original source consoles or 
destination consoles which also receive the messages. 

SEC: Console receives security messages. 

TAP: Console receives messages which apply to the JES3 background utilities 
with JES3-controlled tape requirements, such as tape-to-print or card-to-tape. 

TP: Console receives messages which apply to RJP teleprocessing equipment. 

UR: Console receives messages which apply to the operation of JES3-controlled 
unit record equipment. 

ALL D1 to D22: Console receives messages which apply to a user-defined 
console configuration. Either all of the messages in this group ma}^ be selected 
for this console by specifying BALL, or specific classes in the group may be 
selected by specifying one or a subset from D1 through D22. 

MALL Ml to M32: Console receives messages which are unique to an ASP 
main, JES3 local or JES3 global processor. Either all of the messages in this 
group may be selected for this console by specifying MALL, or specific classes 
in the group may be selected by specifying one or a subset from Ml to M32. 

The destination code is associated with a processor by the MDEST parameter in 
the MAINPROC statement. 
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SALL SI to S32: Console receives messages which pertain to JES3 device 
setup. Either all of the messages in this group may be selected for this console 
by specifying SALL, or specific classes in the group may be selected by 
specifying one or a subset from SI through S32. Setup messages regarding a 
specific device are associated with this console by indicating the destination code 
selected from this group in the JUNIT or XUNIT parameter on the DEVICE 
statement. 

NONE: Console does not receive any messages. This destination code is not 
correlated to any message class. 

OUTPUT: Console receives messages in all classes except MLG. This 
destination code is not correlated to any message class. 

TOTAL: Console receives messages from all 96 message classes including 
MLG. This destination code is not correlated to any message class. 

DEPTH=mi: Specifies the maximum number of messages to be maintained in 
the buffers associated with a RJP console. The DEPTH may be from 1 through 
255. When an RJP console is queued to depth, the queued messages are written 
to spool. To keep track of the status of console buffers, use the *INQUIRY 
operator command. 

Default: 50 

LL=nmi: Specifies the longest line length to be printed on this console. If the 
actual line to be written exceeds this length, the line is broken at a comma or a 
blank and continued on the next line. 

Specify 198 only if you are using a forms control table entry with a printwheel 
ID which has a CPI=15, or if you are using a print image of CPI=15 when using 
a printer which supports a CPI=15. Specify 132 if you are not using a 
printwheel ID which has a CPI=15. 

Default: 120 

LEVEL=nn: Specifies the authority level (0 through 15) for the JES3 console 
authority routine (IATUX18) to check for validity. 

Default: 0 

DEVICE (Device Definition) 

The DEVICE statement defines those devices used by JES3 and those devices 
used by jobs running under JES3. Each uniquely addressable device (card 
reader, punch, local or remote console, or printer) attached to a global, local, or 
ASP main processor must be specified on a DEVICE statement if the default 
characteristics are not satisfactory. The default characteristics are provided by 
the RJPTERM initialization statement. Refer to the OS/VS2 MVS System 
Programming Library: JESS manual for the DEVICE statement parameter 
descriptions. 
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RJPWS (SNA Work Station Definition) 


The RJPWS statement describes a single SNA work station’s characteristics to 
the JES3 system. This statement causes a default description to be provided for 
each work station device (printer, punch, or card reader) indicated by the PR, 
PU, or RD parameter along with the operating characteristics of the work 
station. A DEVICE statement specifying PDIR=ALL should be used to insure 
proper PDIR processing. 

The SNA work station definition is made up of the following parameters. 

N=name: Specifies the 5-character name of the work station. This parameter 
cannot specify the same name specified in the N parameter on an RJPLINE or 
RJPTERM statement. 

The value specified here must be the same as the value specified for the wsname 
operand of the DATA parameter in the host signon specified on display 35.0 
during MSRJE subsystem member configuration at System/36. 

RD=nn: Specifies the maximum number host readers. This number must be an 
integer from 0 through 15. 

The value specified here should not be greater than the value specified for the 
prompt Maximum number of host readers on display 37.0 during MSRJE 
subsystem member configuration at System/36. 

Default: 1 

PR=mi: Specifies the maximum number of printers. This number must be an 
integer between 0 and 15. 

The value specified here should not be greater than the value specified for the 
prompt Maximum number of printers on display 36.0 during MSRJE subsystem 
member configuration at System/36. 

Default: 1 

PU=nn: Specifies the maximum number of punches. This number must be an 
integer from 0 through 15. 

The value specified here should not be greater th^ln the value specified for the 
prompt Maximmn number of punches on display 36.0 during MSRJE subsystem 
member configuration at System/36. 

Default: 0 
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C=(S,R): Specifies the type of console support for the work station. S indicates 
that console and print media share the same presentation services. JESS never 
interrupts data streams to send console messages. R indicates that the console and 
printer are separate real devices. JESS interrupts data streams to send console 
messages. Specify R for System/S6 MSRJE. 

Default: R 

G=grpname: This parameter associates the work station with a group name. The 
grpname specified can be up to 8 characters long. This name is also the default 
destination for any output data set from a job submitted from a work station in the 
group. 

Default: The name specified in the N parameter on this statement. 

COMPACT=NO/comptbl: Specifies the name of the default compaction table. 
System/36 does not support compaction. Specify NO. 

Default: NO. 

P=password: Specifies the 1 through 8 alphameric character password to be used 
by the work station. This password must be included in the user data specified on 
the LOGON command passed to the JES3 LOGON exit by VTAM, or JES3 will 
not accept the logon. 

The value specified here must match the value specified for the password operand 
of the DATA parameter for the host logon on display 35.0 during MSRJE 
subsystem member configuration at System/36. 

PL=n: Specifies the number of invalid logons that can be attempted before the 
work station is rejected. 

Default: 2 

AUTO=(Y,N): Specifies whether automatic logon is supported for the work 
station. 

Default: N 

LU=luname: Specifies the LU names associated with this work station as defined 
to VTAM. The names specified are those LUs that are permitted to logon at this 
work station. 

Default: Logons are accepted from any work station. 

Note: If multiple locations are configured for a single line member definition (using 
CNFIGICF on the System/36), then all LU names that correspond to 
MSRJE sessions defined in the System/36 line member should be defined 
here. This will allow any location to use any LU. 
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SYSOUT (SYSOUT Class Characteristics) 


The SYSOUT initialization statement is required for each JESS output class that 
requires other than TYPE=PRINT processing. Refer the OS/VS2 MVS System 
Programming Library: JESS manual for an explanation of the SYSOUT 
parameters. 


RES Host System Generation 

The creation of a VS 1 system that supports SNA remote work stations requires 
three steps: 

1. A two-stage VSl system generation with the options required to make the 
RTAM modules available in the VSl system, and to include the system code 
needed to use RTAM. The VSl system generation must also specify the 
options required to include VTAM in the system. 

2. A two-stage RTAM generation. This step assembles the desired RTAM 
facilities and link-edits them into the VSl system. 

3. An NCP generation. This step defines SNA work stations as physical and 
logical units to NCP and to VTAM. The NCP generation is a two-step 
process. 

For a complete description of the RES generation process, see the OS/VSl 
RES System Programmer's Guide. 

VSl System Generation Requirements 

As part of a complete VSl system generation, specify OPTIONS=REMOTE in 
the SCHEDULE macroinstruction to condition VSl for the subsequent 
generation of RTAM. 

To make VTAM modules available to control communication with SNA work 
stations, specify ACSMETH=VTAM in the DATAMGT macroinstruction. 

Account Facility modules and RES modules are unconditionally copied during 
VSl generation. 
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RTAM Generation 


RTAM generation is two-stage process that must be performed whenever a new 
VSl release is installed. 


Stage 1 


Stage 1 is an assembly for which the input consists of the following 
installation-coded macroinstructions: 

TERMINAL: This is step 1 of stage 1. You must include the TERMINAL 
macroinstruction to associate an identification number with a work station and 
to specify the terminal device characteristics of the work station. Specify at least 
one TERMINAL macro for each work station. The first TERMINAL 
macroinstruction must immediately follow the last LINE macroinstruction. The 
following parameters define the terminal to RTAM. 

TERMID=tennid: Specifies the terminal number for this work station. 

TDESCR=(w,t,d,f): Specifies the terminal characteristics. 

w print width, specify 3 (132 characters), 
or specify 5 (150 characters) 
if you are using a forms control table entry 
with CPI=15 or a print image which has a CPI=15 when using 
a printer which supports a CPI of 15 
t terminal type, specify 8 (SNA terminal) 
d interface, specify 5 (SNA character string) 
f console support/transparency, specify 4 (console support 
with transparency) 

RDRS=rd: Specifies the number of readers to be used at this work station. If 
this operand is omitted, one reader is assumed. The range of rd is 0 through 9. 

The value specified here should be at least as large as the value specified for the 
prompt. Maximum number of host readers on display 37.0 during MSRJE 
subsystem member configuration at System/36. 

PTRS=pr: Specifies the number of printers at this work station. If this operand 
is omitted, one printer is assumed. The range of pr is 0 through 9. 

The value specified here should not be greater than the value specified for the 
prompt Maximum number of printers on display 36.0 during MSRJE subsystem 
member configuration at System/36. 

PCHS=pu: Specifies whether a punch is at this work station. If this operand is 
omitted, one punch is assumed. The range of pu is 0 through 9. 

The value specified here should not be greater than the value specified for the 
prompt Maximum number of punches on display 36.0 during MSRJE subsystem 
member configuration at System/36. 

CNMSGNO=wtonum: Specifies the maximum number of WTO(R) buffers to 
be available for sending console messages to this work station. 
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CONPR=value: Specifies the printer to be used for console output if console 
support is not specified. If only one printer is defined, that printer is used for 
console support. The number can be from 1 to the number of printers specified. 

Default: CONPR=l. 

PLGN=: Specifies whether to use permanent logon. If you want to use 
permanent logon, specify 1. If you do not want to use permanent logon, specify 
0. If you specify 1, you must also specify the NODE parameter of the 
TERMINAL macro. 

Default: PLGN=0. 

BUFXSIZ=leiigth: Specifies the maximum size (256 or 512) of the VBUF that 
can be sent to/by the SNA work stations being defined. Specify 256 for 
System/36 MSRJE work station support. 

VBUF=tpnum: Specifies the number of teleprocessing buffers RTAM will use 
for this work station. RTAM always uses two buffers for input of data from 
SNA work stations; all other buffers that you specify here are used for data 
output to SNA work stations. 

If you specify less than 3 or omit this operand, RTAM assigns a value of 6 and 
issues a warning message. The value range for the VBUF parameter is any 
integer from 3 through 255. 

SESSLIM=value: Specifies the maximum number of SNA sessions that can be 
initiated for the work station. The value specified here should be at least as 
large as the value specified for Minimum number of sessions on display 34.0 
during MSRJE subsystem configuration at System/36. 

NODE=node name: Required if you specify PLGN=1. Specifies the name of 
an LU macro in the 3705 NCP/PEP generation. The value of the LOCADDR 
parameter on this LU macro must match a logical unit specified for MSRJE on 
display 14.0 during line member definition. 

Note: If multiple locations are configured for a single line member (using 

CNFIGICF on System 136), then all LU macros that have LOCADDR 
parameters that match logical units specified on Display 14.0 (Remote 
System Logical Unit Assignments) must be defined here. This will allow 
any location to use any LU. 

RTAM: The RTAM macroinstruction determines the internal characteristics of 
RTAM. This is step 2 of stage 1. 

TPREAD=readn: Specifies the total number of readers associated with the 
maximum number of work stations that can be logged on at one time. You can 
find this value by adding up the number of readers for all work stations that will 
be logged on at one time. When a work station logs on, RTAM allocates all 
resources for all its job input readers (and also printers and punches). 

Therefore, if you specify too small a value for readn, a user might not be able to 
log on because of insufficient resources. 
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TPPRINT=printn: Specifies the maximum number of concurrent print 
operations. As recommended for TPREAD, you should specify a value for 
TPPRINT that is at least equal to the total number of printers at work stations 
allowed to log on at one time. You can find this value by adding up the number 
of printers for all work stations that will be logged on at one time. Resources 
are allocated as discussed for TPREAD. 

TPPUNCH=punchn: Specifies the maximum number of concurrent punch 
operations. As recommended for TPREAD and TPPRINT, you should specify a 
value for TPPUNCH that is at least equal to the total number of punches at 
work stations allowed to log on at one time. You can find this value by adding 
up the number of punches for all work stations that will be logged on at one 
time. Resource are allocated as discussed for TPREAD. 

MXINTBR=iiixintbr: MXINTBR should equal the larger of 856 or the largest 
BUFXSIZ value specified on the TERMINAL macro. 

PASSWORD=password: Specifies a password that RTAM will use to provide 
additional protection when it issues an OPEN for the VTAM ACB. You must 
identify here the same password that you specified in the PRTCT= password 
operand of the VTAM-definition APL statement that identifies RTAM to 
VTAM as an application. 

SNACOMP=YES/NO: If any work station will use compression/expansion for 
input or print or punch output, specify or default to YES. 

CPACT=YES/NO: Specify NO, System/36 does not support compaction. 

APPLID=name: Specifies the name that RTAM will use when it issues OPEN 
ACB to establish the interface to VTAM. The name you select must also be 
used as the APPLID parameter when you logon to RTAM through VTAM and 
the label on the VTAM APPL statement which defines RTAM as a VTAM 
application. 

With these macroinstructions, you give the specifications that meet your particular 
requirements, and define the telecommunications network to be supported by 
RTAM. 

Output from stage 1 is a series of jobs, which constitute the input for stage 2. 


Stage 2 


Stage 2 consists of the execution of the job output from stage 1. The jobs consist 
of assemblies of the RTAM modules and two link edits of the RTAM modules. 
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Example RES Generation 


Date last changed 03/09/82 
SCP level OS/VS1 - 7A 
PTF level PUT - 8201 
Configuration supported 


Term 

Wrk/Sta 

Line 

Number 

Type 

Cntl 

Number 

Type 

Cntl 

1 

CPU 

SNA 


Terminal Description for CPU-Type Work Stations 


TERMINAL TERMID=1, 

TDESCR=(3,8,5,3), 
RDRS=1, 

PTRS=1, 

PCHS=1, 
BUFXSIZ=256, 
CNMSGNO=5, 

CONPR=1, 

VBUF=14, 

SESSLIM=1, 
CPACTBL=NO, 

PLGN=0 


SNA work station terminal number 
SNA work station attributes 
Number of readers/work station 
Number of printers/work station 
Number of punches/work station 
Maximum size of SNA VBUF 
Number of SNA write to operator buffers 
Use printer if no console support 
Number of SNA TP buffers 
Number of MSRJE SNA sessions 
No SNA compaction table 
No SNA permanent logon 


RTAM Description for RES System Generation 


RTAM TPREAD=6, 

TPPRINT=6, 

TPPUNCH=6, 

MXINTBR=856, 

MSGFCTR=25, 

STBUFNO=24, 

RMT0BJ=SYS1.RTAMOBJ, 

PASSWD=RMSC, 

P0RTS=2, 

SNASCIT=NO, 
HALFGEN=NO, 
SNACOMP=YES, 
CPACT=N0, 

CPACTDF=NO 

APPLID=RTAM 


Total number of readers 

Total number of printers 

Total number of punches 

Single interface buffer size 

Write to operator increase factor 

Number of subtask buffers 

Object library for RES generation 

Password for SNA 

Number of SNA ports 

No ASCII for SNA 

No halfgen 

SNA compression/expansion 
SNA compaction 
SNA compaction table 
Application ID for RES/VTAM 
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3705 NCP/PEP Generation 


The generation procedure for preparing a Network Control Program includes: 

• A generation language by which network configuration and program options 
are specified. 

• A library of macrodefinitions from which the source statements are expanded. 


Generation Lai^age 


The generation language is made up of macroinstructions that fall into four 
categories according to the type of parameters they define. The types of macros 
are: 

1. System macros 

2. Configuration macros 

3. Block handling macros 

4. A generation delimiter macro 


System Macros 


The system macros provide information pertaining to hardware features with which 
the communications controller is equipped, certain network control program 
options, and program generation information such as data set names. 


Configuration Macros 


The configuration macros provide the information necessary to construct the 
control tables needed by the network control program. These tables are used to 
control the flow of data between the 3705 and remote stations or other 3705s, and 
between the 3705 and the host system processor. 

One group of these macros defines the characteristics of the elements in the 
network: 

• Line groups 

• Communications lines 

• Cluster controllers 

• Terminals 

• Components of terminals 

• SNA physical and logical units 
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A macro is coded for each element in the network. The macros must be arranged 
in a specific order to associate a particular communications line with a particular 
line group, or a particular station or a particular SNA physical unit. 

The rest of the configuration macros provide the following types of information: 

• Information needed for data transfer between the communications access 
method and the network control program. 

• Information describing the communication scanner(s) installed in the 3705. 

• Definition of the remaining control tables necessary to control the network. 

If MSRJE is sharing the communications line, you can use multiple unformatted 
system services (USS) tables. For example, if MSRJE and 3270 device emulation 
are sharing a line, you can use: 

• One table with messages defined for message levels 0 and 10 for 3270 device 
emulation 

• Another table without messages defined for message levels 0 and 10 for 
MSRJE 

Note: For MSRJE, you can define messages for message levels 0 and 10 only if you 
use a formatted logon. 


Block Handling Macros 


The block handling macros apply to messages transmitted over binary synchronous 
communications lines. 

Generation Delimiter Macros 

The generation delimiter macro ends the program generation input stream. 

When the programmer has coded the generation macros that describe the network 
to be controlled, the control program is generated using the generation procedure. 
The procedure is executed as a series of jobs in the host processor. 
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PEP Generation for a 3705--II 


Date last changed 03/10/81 
NCP level 7.1 (NCP REL2) 
PTF level PUT - 8011 
Configuration supported 


UCB 

3705 



LINE 

LINE 

TERM 

SUBCHAN 

LINE ADDR 

USE 

SPEED 

CNTL 

NAME 

USAGE 


0A6 

NCP/LSD 

2400 

SDLC 

L0A6 

SNA 


OAO 

NCP/SW 

2400 

SDLC 

LOAD 

SNA 


The following shows an example of what you would write for a nonswitched line. 


LSGRP2 GROUP DIAL=NO, 

LNCTL=SDLC, 

ACTIVTO=420.0, 

REPLYTO=1.0, 

TEXTO=3, 

VIRTUAL=NO, 

INTPRI=1, 

DATRATE=HIGH, 

SPDSEL=NO, 

SERVLIM=4, 

NEWSYNC=NO, 

HDXSP=YES, 

MAXOUT=7, 

PASSLIM=7, 

PUDR=YES, 

ANS=STOP, 

IRETRY=YES, 

BATCH=YES, 

LUDR=YES, 

PACING=(7,1 ) , 

SSCPFM=USSSCS, 

MODETAB=RMSCMT, 

USSTAB=RMSCLT, 

DISCNT=NO, 

VPACING=7, 

TYPE=NCP 


Group macrodefinition 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) VTAM only 
VTAM only 
VTAM only 
VTAM only 
VTAM only 


L0A6 LINE ADDRESS=(0A6), 
DUPLEX=HALF, 
SPEED=2400, 
NRZI=YES, 
CLOCKING=EXT, 
POLLED=YES, 
PAUSE=0, 
HDXSP=YES, 
RETRIES=(5,10,3) , 
MAXPU=8, 

MAXLU=16, 

MAXDATA=265, 


ISTATUS=INACTIVE 


Line macrodefinition 


(default) 

(default; if the host is a 4300 
using ACF/VTAM Version 2 or 
VTAME, then MAXDATA must be 
262.) 
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SERVICE ORDER={PUOA6A,PUOA6B), 
MAXLIST=8 


Service macrodefinition 


PU0A6A PU 


ADDR=C1, 

PUTYPE=2, 

ISTATUS=INACTIVE 


Physical unit definition 


LU0A6A1 LU 


L0CADDR=1, 
ISTATUS=INACTIVE 


Logical unit definition 


PU0A6B PU 


ADDR=C2, 

PUTYPE=2, 

ISTATUS=INACTIVE 


Physical unit definition 


LU0A6B1 LU 


L0CADDR=1, 
ISTATUS=INACTIVE 


Logical unit definition 


The following shows an example of what you would write for a switched line. 


SWGRP2 GROUP DIAL=YES, 

LNCTL=SDLC, 

REPLYT0=1.0, 

TEXTTO=3, 

VIRTUAL=NO, 

HDXSP=YES, 

ANS=STOP, 

INTPRI=1, 
DATRATE=HIGH, 
SPDSEL=NO, 
ANSTONE=NO, 
RING=NO, 

PAUSE=0, 

MAXPU=1, 

TYPE=NCP 

LOAD LINE ADDRESS=(0A0), 
CALL=INOUT, 
DUPLEX=HALF, 
SPEED-2400, 
NRZI-YES, 
CLOCKING-EXT, 
HDXSP-YES, 

PAUSE-0, 
POLLED-YES, 
RETRIES-(5,10,3), 
ISTATUS-ACTIVE, 
VPACING-(2,1) 

PUOAO PU PUTYPE-(1,2), 
MAXLU-32 


Group macrodefinition 
(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

(default) 

Line macrodefinition 


VTAM only 
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MEMBER NAME APPLRTAM 


RTAM1 VBUILD TYPE=APPL 

RTAM APPL ACBNAME=RTAM, 

AUTH=(ACQ,NOCNM,PAS S,NOPO,VPACE) , 
AUTHEXIT=NO, 

EAS=10, 

MODETAB=RMSCMT, 

PARSESS=NO, 

PRTCT=RMSC, 

VPACING=2 

MEMBER NAME SWMSRJE1 


SSUNGL VBUILD TYPE=SWNET, 
MAXNO=5, 
MAXGRP=1 

PU1C PU ADDR=C3, 

IDBLK=03E, 

IDNUM=00806, 

MAXDATA=265, 

DISCNT=(NO,F), 
IRETRY=YES, 

ISTATUS=ACTIVE, 

MAXOUT=7, 

MAXPATH=1, 
PASSLIM=7, 
PUTYPE=2 

PATH1 PATH DIALNO=60534, 

GID=1, 

GRPNM=SWGRP2, 
PID=1, 

REDIAL=0, 

USE=NO 

LU1C1 LU LOCADDR=1, 

BATCH=YES, 

DLOGMOD=SXXRJE, 

ISTATUS=ACTIVE, 

LOGTAB=RMSCIT, 

MODETAB=RMSCMT, 

PACING=(3), 

SSCPFM=USSSCS, 

USSTAB=RMSCLT, 

VPACING=(2) 


define as switched major node 
5 dial numbers 
1 path group 
minor node name 
bits 16-27 of VTAM station ID 
bits 28-47 of VTAM station ID 
maxdata that pu can receive in 
one PIU 

disconnect the phone 
repoll immediate after idle 
detect 

PU is activated at start up 
send 7 PIUs before PU must 
respond 
dial in only 
same as maxout 

System/36 is type 2 PU (3770) 

dial characters for dial out 

group identifier 

group macro name in NCP 

path identifier 

don't re-dial 

don't attempt dial out 

address on physical unit 
processing priority (yes=low 
priority) 

default logmode entry name 
LU is activated at start up 
interpret table name 
default logmode table name 
data transfer between LU and NCP 
default to VTAM USSSCS 
default to USS log table 
data transfer VTAM to NCP 
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MEMBER NAME MODETAB 


//MODETAB JOB ,DKOLSON,CLASS=A 


//TABLE EXEC ASMHCL,FARM.ASM='OBJ,NODECK*, 
// FARM.LKED=(xREF,LIST,LET,NCAL) 

//SYSIN DD * 

TITLE *RMSC - LOGON MODE TABLE* 


RMSCMT MODETAB 
EJECT 


MSRJE FOR SYSTEM/36 - programmer 


SXXRJE 


MODEENT LOGMODE=SXXRJE, 
FMFROF=X'03', 
TSFROF=X'03', 
FRIFROT=X'A3', 
SECFROT=X*A3*, 
COMFROT=X*7080* 
SSNDFAC=X'07', 
SRCVFAC=X*07', 
RUSIZES=X'8585* 
FSNDFAC=X*00', 


entry name 

FM profile 

TS profile 

FLU protocol 

SLU protocol 

common protocol 

secondary send pacing 

secondary receive pacing 

RU size (256) 

primary send pacing 


FSERVIC=X * 01 102000F1OOCOOOOO010040' 


LU presentation 
services 


MODEEND 
END RMSCMT 
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MEMBER NAME USSTAB, 

//USSTAB JOB ,DKOLSON,CLASS=B 

//TABLE EXEC ASMHOL,FARM.ASM='OBJ,NODECK*, 

// FARM.LKED=(XREF,LIST,LET,NCAL) 

//SYSIN DD * 

TITLE 'RMSC - UNFORMATTED SYSTEM SERVICES DEFINITION TABLE* 
RMSCLT USSTAB TABLE=STDTRANS 
LOGON USSCMD CMD=LOGON 
USSFARM FARM=AFFLID 
USSFARM FARM=LOGMODE 
USSFARM FARM=DATA 


LOGOFF 


USSCMD CMD=LOGOFF 
USSFARM FARM=AFFLID 
USSFARM FARM=TYFE,DEFAULT=UNCOND 
USSFARM FARM=HOLD,DEFAULT=NO 


SIGNOFF 


U S S CMD CMD=SIGNOFF 

USSFARM FARM=AFPLID 
USSFARM PARM=TYPE,DEFAULT=UNCOND 
USSFARM PARM=HOLD,DEFAULT=NO 


MESSAGES 


USSMSG MSG=1,TEXT='INVALID COMMAND SYNTAX* 
USSMSG MSG=2,TEXT=* 55 COMMAND NOT RECOGNIZED* 
USSMSG MSG=3,TEXT=* 95 PARAMETER UNRECOGNIZED* 
USSMSG MSG=4 , TEXT= * 95 PARAMETER INVALID* 

USSMSG MSG=5,TEXT=*UNSUPPORTED FUNCTION* 

USSMSG MSG=6,TEXT=* SEQUENCE ERROR* 

USSMSG MSG=7,TEXT=*SESSION NOT BOUND* 

USSMSG MSG=8,TEXT=*INSUFFICIENT STORAGE* 

USSMSG MSG=9,TEXT=*MAGNETIC CARD DATA ERROR* 
USSMSG MSG=11,TEXT='SESSION ENDED* 

USSMSG MSG=12,TEXT=*REQUIRED PARAMETER OMITTED* 
USSMSG MSG=13,TEXT=*IBMECHO 95* 


STDTRANS DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
DC 
END 
END 


X*OOO1O203O4O5O6O7O8O9OAOBOCODOE0F* 
X*101112131415161718191A1B1C1D1E1F* 
X*202122232425262728292A2B2C2D2E2F* 
X* 303132333435363738393A3B3C3D3E3F* 
X'404142434445464748494A4B4C4D4E4F * 
X*505152535455565758595A5B5C5D5E5F* 
X*606162636465666768696A6B6C6D6E6F* 
X*707172737475767778797A7B7C7D7E7F* 
X * 808182838485868788898A8B8C8D8E8F * 
X*909192939495969798999A9B9C9D9E9F* 
X'A0A1A2A3A4A5A6A7A8A9AAABACADAEAF * 
X * BOB1B2B3B4B5B6B7B8B9BABBBCBDBEBF * 
X * COC1C2C3C4C5C6C7C8C9CACBCCCDCECF * 
X * DOD1D2D3D4D5D6D7D8D9DADBDCDDDEDF * 
X * EOE1E2E3E4E5E6E7E8E9EAEBECEDEEEF * 
X'FOF1F2F3F4F5F6F7F8F9FAFBFCFDFEFF * 
USSEND 
RMSCLT 
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OS/vs Host BSC to SNA Conversion Considerations 


You may have to change the setting of the RECFM in the DCB parameter list from 
FB to FBA to indicate that ANSI form control characters are included in the data. 
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VSE/POWER Host System Generation for SNA/MSRJE 


To generate POWER for operation with System/36 MSRJE, you must specify 
parameters of the POWER generation macros and subsequently process these 
macros. For a complete description of VSE/POWER generation, see the 
VSE/POWER Installation and Operation Guide. 


POWER Macro 


The following parameters of the POWER macro are used in defining System/36 
MSRJE work stations. 

COPYSEP: Specifies whether VSE/POWER should produce separator 
pages/cards between each copy of an output file. If NO is specified, the separator 
pages/cards are suppressed. If YES is specified, separator pages/cards are 
included between each copy of an output file. However, copy separation is done 
only for nonzero JSEP specification, defined either during VSE/POWER 
generation or in a JECL (Job Entry Control Language) statement. 

Default: YES. 

DBLK: Specifies the block size of data file records and, consequently, the size of 
each data buffer. Data buffers are used as I/O areas by the execution processors, 
readers/writers, and RJE routines. The value specified for DBLK must be an 
integer in the range 544 to 2008. 

JSEP=n,m: Specifies that special pages or cards are to be included in the output to 
separate job entries, n specifies the number of separator pages to be printed across 
perforations, m specifies the number of separator cards, n and m may be any digit 
from 0 through 9. The minimum number of separator cards is 3. For print output, 
one additional page as specified by n will be printed except if 0 is specified. If 
JSEP is omitted, (0,0) is assumed. 

SNA: Specifies POWER as a VTAM application program. The following SNA 
subparameters are used in defining System/36 MSRJE work stations. 

LUCOUNT: Specifies the total number of LU-to-LU sessions that can exist at 
one time. Each work station potentially represents multiple sessions. A value in 
the range 1 through 200 can be specified. System/3 6 MSRJE supports up to 46 
LU“tO“LU sessions. 

PASSWORD: Specifies in 1 through 8 alphameric characters, the password 
presented to VTAM. If specified, the password must match the PRTCT 
parameter of the VTAM APPL application definition statement. 

Default: No password. 

APPLID: Specifies, in 1 through 8 alphameric characters, the name that the 
host has assigned to POWER. If specified, the value must match the name field 
of the VTAM APPLID definition for POWER. 

Default: POWER. 
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The PRMT macro and its parameters define the hardware characteristics of an RJE 
terminal. At least one PRMT macro must be supplied for each user. The PRMT 
macros must be specified in ascending sequence according to their remote-IDs, and 
the definitions for non-SNA remote-IDs must precede the definitions for SNA 
remote-IDs. The following parameters make up the PRMT macro. 

REMOTE: Specifies an identification number for the work station. Work stations 
are numbered consecutively from 1 to 200. The first must be specified as 1, and 
succeeding work stations must be specified in increments of 1. 

TYPE: For SNA support, the terminal must be specified as LUTl. 

CONSOLE: May be specified only for an SNA work station and only if this work 
station has a line printer in addition to the normal terminal console. 

YES causes VSE/POWER to interrupt the outbound printer flow whenever 
messages are generated for the remote operator. 

NO prevents VSE/POWER from interrupting an outbound printer flow for the 
transmission of messages to the remote operator. In this case, the messages are 
collected and submitted to the operator after POWER END OF JOB has been 
reached. 

PSWRD: Specifies the security password that may have been defined for the 
remote work station being described. The password must match the password 
contained in the user data of the LOGON command. 

The value specified must match the entry made for the password operand of the 
DATA parameter in the host LOGON specified on display 35.0 during MSRJE 
subsystem configuration at System/36. 

SESSLIM: Specifies the maximum number of SNA sessions that can exist 
concurrently. The maximum value that can be specified is 6. 

The value specified here must be at least as large as the value specified for the 
prompt Minimimi number of sessions on display 34.0 during MSRJE subsystem 
member configuration at System/36. 

CMP ACT: Specifies the name of the default compaction table to be used for this 
remote work station. System/36 does not support compaction. 

LU: Specifies the symbolic name, or names, of this work station as they are known 
to VTAM. These names must be the same ones used in the VTAM logical unit 
definitions. 

Note: If multiple locations are configured for a single line member definition (using 
CNFIGICF on System/36), then all LU names that correspond to MSRJE 
sessions defined in the System/36 line member should be defined here. This 
will allow any location to use any LU. 

For additional information on VSE/POWER generation, refer to the 
VSE/POWER Installation and Operations Guide. 
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Appendix A. Host Subsystem Work Sheets 


The following work sheets should be used to coordinate System/36 MSRJE 
configuration and the host subsystem generation. The values that must be the same 
for System/36 and the host subsystem are defined by indicating the System/36 
CNFIGICF procedure display number and prompt and the host subsystem 
generation parameter. 

It is recommended that you either have the host system personnel fill out the work 
sheet and then use those values to configure MSRJE, or configure MSRJE, fill out 
the work sheet and then give the work sheet to the host system personnel. 

Note: Changes to the host subsystem parameters and their default values sometimes 
occur between releases. Therefore, the information given here may not exactly 
reflect the host subsystem release with which you are operating. 
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BSC 

SYSTEM/36 MULTIPLE SESSION REMOTE JOB ENTRY 
JES2 HOST SUBSYSTEM WORK SHEET 


JES2 BSC SIGNON 

Enter the text to be used as the SIGNON command that the JES2 host subsystem 
is expecting from System/36. The value specified on display 35.0 during 
subsystem member configuration at System/36 must match the value expected by 
JES2. 


12 3 4 

10 0 0 0 


4 5 6 7 8 

1 0 0 0 0 


JES2 uses the following SIGNON command format: 

1 2 

6 5 

/♦SIGNON fREMOTEnn^ [passwrdi] 
^RMTnnn j 


7 

31 

[passwrd2] 

S7909030-0 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The REMOTEnn or RMTnnn parameter begins in 
position 16 and must match the value specified for 
System/36 in the RMTnnn parameter of the JES2 work 
station definition. 

35.0 



The passwrdi parameter is optional and, if used, begins 
in position 25 and must match the value specified for 
the PASSWORD subparameter of the LINEnnn 
parameter during definition of remote work stations for 
JES2 at the host system. 

35.0 


No password 

The passwrd2 parameter is optional and, if used, must 
begin in position 73 and must match the value specified 
for the PASSWORD subparameter of the RMTnnn 
parameter during remote work station definition for 

JES2 at the host system. 

35.0 


No password 
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JES2 BSC Configuration 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The value specified for the MLBFSIZ JES2 
initialization parameter. The value specified for Buffer 
length on display 11.0 during line member 
configuration at System/3 6 must match this value. 

11.0 


400 

The value specified for the NUMRD subparameter of 
the RMTnnn parameter on the JES2 work station 
definition. The value specified for Maximum number of 
host readers on display 37.0 during subsystem member 
configuration at System/36 must be less than or equal 
to this value. 

37.0 


1 

The value specified for the NUMPR subparameter of 
the RMTnnn parameter on the JES2 work station 
definition. The value specified for Maximum number of 
printers on display 36.0 during subsystem member 
configuration at the system/3 6 must be at least as large 
as this value. 

36.0 


1 

The value specified for the NUMPU subparameter of 
the RMTnnn parameter on the JES2 work station 
definition. The value specified for Maximum number of 
punches on display 36.0 during subsystem member 
configuration at System/3 6 must be at least as large as 
this value. 

36.0 


0 

Whether TRANSP or NOTRANSP is specified on the 
LINEnnn parameter and the RMTnnn parameter for 

JES2. TRANSP indicates that transparency is 
supported; NOTRANSP indicates that transparency is 
not supported. TRANSP must be specified on both the 
LINEnnn and RMTnnn parameters if transparency is to 
be used with System/36. Transparency can be selected 
at System/36 for the Transparency? prompt on display 
37.0 during subsystem member configuration. 

37.0 


NOTRANSP 
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BSC 

SYSTEM/36 MULTIPLE SESSION REMOTE JOB ENTRY 
JES3 HOST SUBSYSTEM WORK SHEET 


JES3 BSC SIGNON 

Enter the text to be used as the SIGNON command that the JES3 host subsystem 
is expecting from System/36. The value specified on display 35.0 during 
subsystem member configuration at System/36 must match the value expected by 
JES3. 



1 

2 

3 

4 

1 

1 1 1 1 

0 

1 1 1 1 1 1 1 1 1 1 

0 

1 1 1 1 1 1 t t 1 i 

0 

0 

1 1 1 1 

4 

1 I 1 1 I 1 1 1 1 1 

5 

1 1 1 1 1 I 1 [ i I 

6 

1 1 I 1 i 1 I 1 I 1 

7 

1 1 1 1 I 

8 

1 

0 

0 

0 

0 


I l_l_l l_l I l_l I I I I I I I 


JES3 uses the following SIGNON command format: 

12 2 3 

1 6 2 5 5 

/*SIGNON namex[A] passwrdl passwrd2 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The namex parameter begins in position 16 and must 
match the value specified for System/36 by the N 
parameter in the RJPTERM statement during JES3 
generation at the host system. 

35.0 



The A in position 22 is optional and, if used, defines 
System/3 6 as a programmable RJE work station with 
readers that do not require operator intervention 
(automatic readers). 

35.0 



The passwrdl parameter begins in position 25 and must 
match the value specified for the P subparameter of the 
RJPLINE parameter during JES3 generation at the 
host system. The value is 1 through 8 alphameric 
characters. 

35.0 


8 blanks 

The passwrdl parameter begins in position 35 and must 
match the value specified for the P subparameter in the 
RJPTERM statement during JES3 generation at the 
host system. The value is 1 through 8 alphameric 
characters. 

35.0 


8 blanks 
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JES3 BSC Configuration 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The value specified for the B subparameter of the 
RJPTERM statement during JES3 work station 
definition at the host system. The value specified for 
Buffer length on display 11.0 during line member 
configuration at System/36 must match this value. 

11.0 


400 

The value specified for the RD subparameter of the 
RJPTERM statement during JES3 work station 
definition. The value specified for Maximum number of 
host readers on display 37.0 during subsystem member 
configuration at System/3 6 must be less than or equal 
to this value. 

37.0 


0 

The value specified for the PR subparameter of the 
RJPTERM statement during JES3 work station 
definition. The value specified for Maximum number of 
printers on display 36.0 during subsystem member 
configuration at System/36 must be at least as large as 
this value. 

36.0 


0 

The value specified for the PU subparameter of the 
RJPTERM statement during JES3 work station 
definition. The value specified for Maximum number of 
punches on display 36.0 during subsystem member 
configuration at System/36 must be at least as large as 
this value. 

36.0 


0 

Whether F=NTRS is specified on the RJPTERM 
statement during JES3 work station definition. 

F=NTRS indicates that transparency is not supported. 
Transparency can be selected at System/36 for the 
Transparency? prompt on display 37.0 during 
subsystem member configuration. 

37.0 


Transparency 
is assumed 


Appendix A. Host Subsystem Work Sheets A-5 























BSC 

SYSTEM/36 MULTIPLE SESSION REMOTE JOB ENTRY 
RES HOST SUBSYSTEM WORK SHEET 

RES BSC LOGON 

Enter the text to be used as the LOGON command that the RES host subsystem is 
expecting from System/36. The value specified on display 35.0 during subsystem 
member configuration at System/36 must match the value expected by RES. 

12 3 4 

1 0 0 0 0 

4 5 6 7 8 

1 0 0 0 0 


RES uses the following LOGON command format: 


LOGON useridC/password] TERM (termid) [ PROC (procname)] fNOTICES 

j^NONOTICESJ 


f MAIL '1 
^NOMAILJ 


Generation Parameter Description 

Systeni/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The userid parameter must match the value specified 
for System/36 on the ADD subcommand of the 
account command. 

35.0 



The password parameter is optional and, if used, must 
be separated from the userid by a slash (/) and must 
match the value specified in the ADD command 
(during RTAM generation) for the associated userid. 

The value is 1 through 8 alphameric characters. 

35.0 



The TERM parameter identifies the RJE work station 
and must match the value specified for System/36 in 
the TERMID parameter of the TERMINAL macro for 
the RTAM generation. 

35.0 



The PROC parameter allows you to specify a cataloged 
procedure at the host system that is to be executed as a 
part of the logon process. 

35.0 
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RES BSC Configuration 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

NOTICES/NONOTICE allov/s you to specify whether 
all general notices from RES are to be listed at 

System/36 after logon. NOTICES, the default, 
specifies that notices will be listed; NONOTICES 
specifies that notices are not to be listed. 

35.0 

MAIL/NOMAIL allows you to specify whether 
messages directed to System/3 6 are to be automatically 
listed after logon. MAIL, the default, specifies that 
messages are to be listed. NOMAIL specifies that 
messages are not to be automatically listed. 

35.0 

The value specified for the TFBFSIZ parameter of the 
RTAM macro for the RTAM stage 1 generation at the 
host system. The value specified for Buffer length on 
display 11.0 during line member configuration at 
System/36 must match this value. 

11.0 

The value specified for the RDRS parameter of the 
TERMINAL macro for the RTAM stage 1 generation. 

The value specified for Maximum number of host 
readers on display 37.0 during subsystem member 
configuration at System/36 must be less than or equal 
to this value. 

37.0 

The value specified for the PTRS parameter of the 
TERMINAL macro for the RTAM stage 1 generation. 

The value specified for Maximum number of printers on 
display 36.0 during subsystem member configuration at 
System/36 must be at least as large as this value. 

36.0 

The value specified for the PCHS parameter of the 
TERMINAL macro for the RTAM stage 1 generation. 

The value specified for Maximum number of pimches on 
display 36.0 during subsystem member configuration at 
System/36 must be at least as large as this value. 

36.0 

The value specified for subparameter 4 of the TDESCR 
parameter of the TERMINAL macro for the RTAM 
stage 1 generation. If that value is 2, transparency for 
the terminal is not supported. If the value is 3, 
transparency for the terminal is supported. The value 
specified for subparameter 2 of the LDESCR 
parameter of the LINE macro for the RTAM stage 1 
generation. If that value is 0, transparency for the line 
is not supported. If the value is 1, transparency for the 
line is supported. These values correspond to the 
Transparency? prompt on display 37.0 during 
subsystem member configuration at System/36. 

37.0 


Host 

Host 

Configuration 

Default 

Entry 

Value 
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BSC 

SYSTEM/36 MULTIPLE SESSION REMOTE JOB ENTRY 
VM/370 RSCS HOST SUBSYSTEM WORK SHEET 


VM/370 RSCS SIGNON 


Enter the text to be used as the SIGNON command that the RSCS host subsystem 
is expecting from System/36. The value specified on display 35.0 during 
subsystem member configuration as System/36 must match the value expected by 
RSCS. 


12 3 4 

1 0 0 0 0 

4 5 6 7 8 

1 0 0 0 0 


RSCS uses the following SIGNON command format: 

1 2 
1 6 5 

/* SIGNON REMOTEnn[password] 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The REMOTEnn parameter begins in position 16 and 
must match the value specified by the Mrn parameter 
for System/36 in the START command for RSCS at 
the host system. 

35.0 



The password parameter is optional and, if used, begins 
in position 25 and must match the value specified for 
password in the START command at the host system. 

The value is 1 through 8 alphameric characters. I 

35.0 


No password 
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VM/370 RSCS Configuration 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The value specified for the Bnnnn parameter of the 

RSCS START command. The value specifed for 

Buffer length on display 11.0 during line member 
configuration at System/36 must match this value. 

11.0 


400 

RSCS supports one reader only. Specify 1 for the 
Maximum number of host readers on display 37.0 during 
subsystem member configuration at System/36. 

37.0 

1 


RSCS supports 0 or 1 printer. If your application 
generates print output that is returned to System/36, 
specify 1 ; otherwise, specify 0. The value specified for 
Maximum number of printers on display 36.0 during 
subsystem member configuration at System/36 must be 
at least as large as this value. 

36.0 



RSCS supports 0 or 1 punch. If your application 
generates punch output that is returned to System/36, 
specify 1; otherwise, specify 0. The value specified for 
Maximum number of punches on display 36.0 during 
subsystem member configuration at System/36 must be 
at least as large as this value. 

36.0 



RSCS always sends punch data in transparent mode 
and accepts transparent data. Specify Y for the 
Transparency? prompt on display 37.0. 

37.0 

Y 
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SNA 

SYSTEM/36 MULTIPLE SESSION REMOTE JOB ENTRY 
NCP/VTAM CONFIGURATION WORK SHEET 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The value specified for the IDBLK parameter of PU 
macro during NCP/VTAM generation must be 03E for 
System/36. 

13.0 



The values specified for the IDNUM parameter of PU 
macro during NCP/VTAM generation. The value 
specified for Local system’s station XID in hexadecimal 
on display 13.0 during line member configuration at 
System/36 must be equal to this value. 

13.0 



The value specified for the ADDR parameter of the PU 
macro during NCP/VTAM generation. The value 
specified for Local system’s station address on display 

13.0 during line member configuration at System/36 
must be the same as this value. 

13.0 



The value specified in the START procedure for 
NCP/VTAM as the system services control point 
identifier (SSCPID). The value specified for SSCP 
identification on display 13.0 during line member 
configuration at System/36 must be the same as this 
value. 

13.0 


ft 

The values specified for the LOCADDR parameters of 
the LU macros during NCP/VTAM generation. The 
values selected on display 14.0 during line member 
configuration at System/36 must equal these values. 

Up to 255 LU addresses can be assigned to System/36. 

14.0 


‘ 

The name assigned to the log mode table to be used for i 
MSRJE. The name is specified by the MODETAB 
parameter of the PU macro. 

35.0 
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SNA 

SYSTEM/36 MULTIPLE SESSION REMOTE JOB ENTRY 
JES2 HOST SUBSYSTEM WORK SHEET 

JES2 SNA LOGON 

Enter the text to be used as the LOGON command that the JES2 host subsystem is 
expecting from the System/36. The value specified on display 35.0 during 
subsystem member configuration at System/36 must match the value expected by 
JES2. 

12 3 4 

1 0 0 0 0 

4 5 6 7 8 

1 0 0 0 0 

I I I I I l_l I I 1 l_l I I I l_l_l l_ 


JES2 uses the following LOGON command format; 

LOGON APPLID(JES2)[LOGMODE(modename)][DATA(RMTnn [,password1] [,password2])] 


Generation Parameter Description 

Systeni/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The value for the APPLID parameter is normally 
specified as JES2. 

35.0 


JES2 

The value entered for the LOGMODE parameter, if 
used, specifies the name of an entry in a table at the 
host system that contains the operating parameters for 
SNA communications. You should obtain the name of 
the LOGMODE entry from the host system personnel. 

The table that contains the entry specified is selected 
by the MODETAB parameter of the PU macro during 
NCP/VTAM generation at the host system. The table 
itself is defined using the MODEENT macro. 

35.0 



The values entered for the DATA parameter. 




The RMTnnn parameter specifies the terminal number 
of System/36 as specified in the RMTnnn parameter of 
the host system’s remote terminal description. 

35.0 



The passwordl parameter is optional and, if specified, is 

1 through 8 alphameric characters and must match the 
password specified for the PASSWORD subparameter 
of the LINEnnn parameter during the definition of a 
remote work station for JES2 at the host system. 

35.0 


8 blanks 
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JES2 SNA Configuration 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The password2 parameter is optional and, if used, is 1 
through 8 alphameric characters and must match the 
value specified for the PASSWORD parameter of the 
RMTnnn parameter during remote work station 
definition for JES2 at the host system. 

35.0 


No password 

The value specified for the NUMRD subparameter of 
the RMTnnn parameter on the JES2 work station 
definition. The value specified for Maximum number of 
host readers on display 37.0 during subsystem member 
configuration at System/3 6 must be less than or equal 
to this value. 

37.0 


1 

The value specified for the NUMPR subparameter of 
the RMTnnn parameter on the JES2 work station 
definition. The value specified for Maximum number of 
printers on display 36.0 during subsystem member 
configuration at System/3 6 must be at least as large as 
this value. 

36.0 


0 

The value specified for the NUMPU subparameter of 
the RMTnnn parameter on the JES2 work station 
definition. The value specified for Maximum number of 
punches on display 36.0 during subsystem member 
configuration at System/36 must be at least as large as 
this value. 

36.0 


0 
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SNA 

SYSTEM/36 MULTIPLE SESSION REMOTE JOB ENTRY 
JES3 HOST SUBSYSTEM CONFIGURATION WORK SHEET 


JES3 SNA LOGON 

Enter the text to be used as the LOGON command that the JESS host subsystem is 
expecting from System/36. The value specified on display 35.0 during subsystem 
member configuration as System/36 must match the value expected by JESS. 

12 3 4 

1 0 0 0 0 


4 5 6 7 8 

1 0 0 0 0 


JESS uses the following LOGON command format: 

LOGON APPLID(JES3)[LOGMODE(modename)][DATA(wsname,password)] 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The value for the APPLID parameter is normally 
specified as JES3. 

35.0 


JES3 

The value entered for the LOGMODE parameter, if 
used, specifies the name of an entry in a table at the 
host system that contains the operating parameters for 
SNA communications. You should obtain the name of 
the LOGMODE entry from the host system personnel. 

The table that contains the entry specified is selected 
by the MODETAB parameter of the PU macro during 
NCP/VTAM generation at the host system. The table 
itself is defined using the MODEENT macro. 

35.0 



The values entered for the DATA parameter. 




The wsname parameter must match the value specified 
for System/36 by the N parameter in the RJPWS 
statement during JES3 generation at the host system. 

35.0 



The password parameter must match the value specified 
for the P parameter of the RJPWS parameter during 

JES3 generation at the host system. The value is 1 
through 8 alphameric characters. 

35.0 
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JES3 SNA Configuration 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The value specified for the RD subparameter of the 
RJPWS statement during JES3 work station definition. 
The value specified for Maximum number of host 
readers on display 37.0 during subsystem member 
configuration at System/3 6 must be less than or equal 
to this value. 

37.0 


1 

The value specified for the PR subparameter of the 
RJPWS statement during JES3 work station definition. 
The value specified for Maximum number of printers on 
display 36.0 during subsystem member configuration at 
System/36 must be at least as large as this value. 

36.0 


1 

The value specified for the PU subparameter of the j 

RJPWS statement during JES3 work station definition. 
The value specified for Maximum number of punches on 
display 36.0 during subsystem member configuration at 
System/36 must be at least as large as this value. 

36.0 


0 
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SNA 

SYSTEM/36 MULTIPLE SESSION REMOTE JOB ENTRY 
RES HOST SUBSYSTEM CONFIGURATION WORK SHEET 


RES SNA LOGON 

Enter the text to be used as the LOGON command that the RES host subsystem is 
expecting from System/36. The value specified on display 35.0 during subsystem 
member configuration as System/36 must match the value expected by RES. 

12 3 4 

1 0 0 0 0 

4 5 6 7 8 

1 0 0 0 0 


RES uses the following LOGON command format: 

LOGON APPLID(RTAM)[ LOGMODE(mode)] 

DATA('useridC/password] TERM (termid) [ PROG (procname)] [fNOTICES "^^IffMAIL 1 ') 

^NONOTICESJ h NOMAILJ 

S7909032-0 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The value for the APPLID parameter is normally 
specified as RTAM. 

35.0 


RTAM 

The value entered for the LOGMODE parameter, if 
used, specifies the name of an entry in a table at the 
host system that contains the operating parameters for 
SNA communications. You should obtain the name of 
the LOGMODE entry from the host system personnel. 

The table that contains the entry specified is selected 
by the MODETAB parameter of the PU macro during 
NCP/VTAM generation at the host system. The table 
itself is defined using the MODEENT macro. 

35.0 



The values entered for the DATA parameter. 

. . 1 




The userid parameter must match the value specified 
for System/36 on the ADD subcommand of the 
ACCOUNT command. 

35.0 
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RES SNA Configuration 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

The password parameter is optional and, if used, must 
be separated from the userid by a slash (/) and must 
match the value specified in the ADD command (for 
the RTAM generation) for the associated userid. The 
value is 1 through 8 alphameric characters. 

35.0 

The TERM parameter identifies the RJE work station 
and must match the value specified for System/36 in 
the TERMID parameter of the TERMINAL macro for 
the RTAM generation at the host system. 

35.0 

FIT’3’.The PROC parameter allows you to specify a 
cataloged procedure at the host system that is to be 
executed as a part of the logon process. 

35.0 

NOTICES/NONOTICE allows you to specify whether 
all general notices from RES are to be listed at 

System/36 after logon. NOTICES, the default, 
specifies that notices will be listed; NONOTICES 
specifies that notices are not to be listed. 

35.0 

MAIL/NOMAIL allows you to specify whether 
messages directed to System/36 are to be automatically 
listed after logon. MAIL, the default, specifies that 
messages are to be listed. NOMAIL specifies that 
messages are not to be automatically listed. 

35.0 

The value specified for the RDRS parameter of the 
TERMINAL macro for the RTAM stage 1 generation 
at the host system. The value specified for Maximum 
number of host readers on display 37.0 during 
subsystem member configuration at System/3 6 must be 
less than or equal to this value. 

37.0 

The value specified for the PTRS parameter of the 
TERMINAL macro for the RTAM stage 1 generation. 

The value specified for Maximum number of printers on 
display 36.0 during subsystem member configuration at 
System/36 must be at least as large as this value. 

36.0 

The value specified for the PCHS parameter of the 
TERMINAL macro for the RTAM stage 1 generation. 

The value specified for Maximum number of punches on 
display 36.0 during subsystem member configuration at 
System/36 must be at least as large as this value. 

36.0 


Host Host 

Configuration Default 

Entry Value 
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SNA 

SYSTEM/36 MULTIPLE SESSION REMOTE JOB ENTRY 
VSE/POWER HOST SUBSYSTEM WORK SHEET 


VSE/POWER SNA LOGON 

Enter the text to be used as the LOGON command that the VSE/POWER host 
subsystem is expecting from System/36. The value specified on display 35.0 
during subsystem member configuration as System/36 must match the value 
expected by VSE/POWER. 

12 3 4 

1 0 0 0 0 

4 5 6 7 8 

1 0 0 0 0 


VSE/POWER uses the following LOGON command format: 


LOGON APPLID(POWER)[LOGMODE(modename)][DATA('remid,[passv7ord],[user information] ')] 

S7909036-0 


Generation Parameter Description 

Systein/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The value for the APPLID parameter is normally 
specified as POWER. 

35.0 


POWER 

The value entered for the LOGMODE parameter, if 
used, specifies the name of an entry in a table at the 
host system that contains the operating parameters 
for SNA communications. The table that contains 
the entry specified is selected by the MODETAB 
parameter of the PU macro during NCP/VTAM 
generation at the host system. The table itself is 
defined using the MODEENT macro. 

35.0 



The values entered for the DATA parameter. 




The remid parameter identifies the remote ID 
assigned to System/36 during VSE/POWER 
generation at the host system. It must match the 
value specified for the REMOTE parameter in the 
PRMT statement during VSE/POWER generation. 

35.0 



The password parameter, if used, is 1 through 8 
alphameric characters and must match the value 
specified for the PSWRD subparameter of the 

PRMT statement. 

35.0 
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Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

The user information, if used, can be up to 16 bytes 
of data. Ask the host system personnel whether this 
information is needed. 

35.0 




VSE/POWER SNA Configuration 


Generation Parameter Description 

System/36 

CNFIGICF 

Display 

Host 

Configuration 

Entry 

Host 

Default 

Value 

VSE/POWER supports one reader only. Specify 1 for 
the Maximum number of host readers on display 37.0 
during subsystem member configuration at System/36. 

37.0 

1 


VSE/POWER supports up to 3 printers. If your 
application generates print output that is returned to 
System/36, specify 1, 2, or 3; otherwise, specify 0. 

The value specified for Maximum number of printers on 
display 36.0 during subsystem member configuration at 
System/36 must be at least as large as this value. 

36.0 



VSE/POWER supports 0 or 1 punches. If your 
application generates punch output that is returned to 
System/36, specify 1; otherwise, specify 0. The value 
specified for Maximum number of punches on display 

36.0 during subsystem member configuration at 
System/36 must be at least as large as this value. 

36.0 
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Appendix B. System/36 SNA MSRJE Bind Command Format 


VTAM is responsible for sending the bind command to System/36. Receipt of a 
correctly formatted bind command is required before MSRJE can be successfully 
started. 

Note: If System/36 rejects the received bind command, you should contact the host 
personnel to verify the contents of the entire bind command. This is necessary 
because when System/36 detects an invalid byte in the bind command, it 
rejects that bind command and performs no further checking. Therefore, even 
if you correct the detected invalid byte, any remaining invalid bytes will cause 
further rejections of the bind command. 

The bind command received by System/36 must contain the following entries: 


Byte 

(Decimal) 

Recommended 

Hex 

Value 

MODETAB 

Operand 

Name 

2 

03 

FMPROF 

3 

03 

TSPROF 

4 

A1 or A3* 

PRIPROT 

5 

A1 or A31 

SECPROT 

6,7 

7080 

COMPROT 

8 

07 

SSNDPAC 

9 

07 

SRCVPAC 

10,11 

8585 

RUSIZES 


Meaning 

Function management (FM) profile. 

Transmission services (TS) profile. 

Primary logical unit profile. 

Secondary logical unit profile. 

Common protocol. Hex 7080 specifies that function 
management headers are used, brackets are used, bracket 
termination rule 1 is used, and alternate code is used. 

Secondary send pacing. 

Secondary receive pacing. 

Request/response unit size. Hex 8585 specifies 256 
bytes, as required by MSRJE. 


Specify A3 if you want compression. 
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Byte 

(Decimal) 

Recommended 

Hex 

Value 

MODETAB 

Operand 

Name 

Meaning 

14-25 


PSERVIC 

Presentation services (PS) profile (12 bytes). 

14 

01 

PSERVIC, 
byte 1 

Hex 01 specifies logical unit presentation services 

profile 1. 

15 

10 

PSERVIC, 
byte 2 

Hex 10 specifies function management header subset 1. 

16,17 

2000 

PSERVIC, 
bytes 3 and 4 

Specifies the primary function management header subset 
flags. Hex 2000 specifies that PDIRs should be sent. 

18 

FI 

PSERVIC, 
byte 5 

Primary data stream subset flags. Hex FI specifies 
interactive data stream, horizontal format data stream, 
vertical tab data stream, vertical select data stream, and 
transparency data stream. 

19 

00 

PSERVIC, 
byte 6 

Not used. Specify hex 00. 

20 

CO 

PSERVIC, 
byte 7 

Primary media flags. Hex CO specifies document output 
and card format. 

21,22 

0000 

PSERVIC, 
bytes 8 and 9 

Specifies the secondary function management header 
subset flags. Specify 0000, 

23 

01 

PSERVIC, 
byte 10 

Secondary data stream subset flags. Specify hex 01 for 
transparency data stream. 

24 

00 

PSERVIC, 
byte 11 

Not used. Specify hex 00. 

25 

40 

PSERVIC, 
byte 12 

Specifies the secondary media flags. Specify hex 40 for 
card format. 


For a complete description of the bind command format, see the VTAM System 
Programmer's Guide, 


V 
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Appendix C. MSRJE Examples 


Two examples of MSRJE are provided in this appendix. Included for each are the 
configuration displays (from the CNFIGICF procedure), the MSRJE utility control 
statements, and the host system JCL sent by MSRJE to the host system. 

The definition of the forms control table is also shown. The same table is used for 
both examples. 


Systeni/36 MSRJE to RES (BSC) 


This example illustrates using System/3 6 MSRJE to communicate with a BSC host 
system that is running RES under OS/VSl. Communications will occur over a 
nonswitched communications line. 

Line Member Configuration 

The following displays show the attributes specified for the BSC line member, 
which is named REBSCLl and is in library RJELIB. 



The name (REBSCLl) entered for prompt 1 is referenced on display 20.0 during 
subsystem member configuration. 
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2.0 


SSP-ICF CONFIGURATION MEMBER TYPE 


REBSCL1 


Select one of the following options: 

1. INTRA 

2. BSC 

3. SNA 

4. ASYNC 


Option 2 


Cmd3~Previous display Cmdl9-Cancel 

COPR IBM Corp. 1986 




3.0 BSC CONFIGURATION MEMBER TYPE REBSCL1 

1 . BSC member type.... 1,2 2 


1. BSC subsystem member 

2. BSC line member 



Cmdl9“Cancel 

COPR IBM Corp. 


1986 ^ 
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10.5 


REMOTE SYSTEM SELECTION 


REBSCL1 


W1 


A 


1. Select from the following options: 

1-Create 

Option . 1 

2. Remote system name . NBSRES 


OPTION REMOTE SYSTEM 


OPTION REMOTE SYSTEM 


OPTION REMOTE SYSTEM 


CmdS-Reset Cmd19-Cancel 




11.0 REMOTE SYSTEM ATTRIBUTES 

Remote system NBSRES 


REBSCL1 W1 


2. Buffer length 


200-4096 1880 


Cmd7-End Cmdl9-Cancel 




The name (NBSRES) entered for prompt 1 is referenced during subsystem member 
configuration on display 29.0. 

The value (1880) entered for prompt 3 must match the value specified at the host 
system for the TPBFSIZ parameter of the RTAM macro during RTAM stage 1 
generation. 
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Subsystem Member Configuration 


The following displays show the attributes specified for the BSC subsystem 
member, which is named REBSCSl and is in library RJELIB. 



Note that the library specified for prompt 2 must be the same library in which the 
associated line member (REBSCLl) is stored. 
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3.0 BSC CONFIGURATION MEMBER TYPE REBSCS1 I 

1. BSC member type.1,2 1 


1. BSC subsystem member 

2. BSC line member 


Cmdl9-Cancel 

COPR IBM Corp. 1986 




The line member name was specified on display 1.0 during line member 
configuration. 
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29.0 REMOTE LOCATION SELECTION REBSCS1 

1. Select from the following options: 

1-Create 

Option . 1 

2. Remote location name.LOCI 

3. Remote system name . NBSRES 


OPTION LOCATION 


REMOTE SYSTEM 
NBSRES 


Page 1 of 1 


CmdS-Reset 


Cmdl9-Cancel 


Roll-Page 


The remote system in the line member is NBSRES, as specified on display 11.0 
during line member configuration. 
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The value (NBSRES) is carried over from display 29.0, and was originally defined 
on display 11.0 during line member configuration. The location name (LOCI) is 
the value used in the MSRJE procedure command to start a session with this 
location. 


34.0 MSRJE SUBSYSTEM MEMBER ATTRIBUTES 

Remote system NBSRES Remote location LOCI 


REBSCS1 W1 


1 . Host name ..RES 

2. Termination delay in minutes . 0-99,blank 

3. Priority . H,M,N,L N 


6. Display informational messages? . . . Y,N Y 


Cmdl9-Cancel 




35.0 MSRJE LOGON ATTRIBUTES 

Remote system NBSRES Remote location LOCI 


REBSCS1 W1 


3. Enter host LOGON/SIGNON command below: 

_10_: . . .20_: . . .30_: . . .40_: . . .50_: . . .60_; . . .70_:_ 

LOGON DEV03 TERM(3) PROC(MRJEPROC) 


Cmdl9-Cancel 
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The value (MRJEPROC) specified for the PROC parameter of the LOGON 
command identifies a procedure at the host system that is to be started when 
System/36 logs on to the host system. The procedure is stored in SYSl.PROCLIB. 



The forms control table (FCT) is described under “Creating the Forms Control 
Table’’ later in this appendix. Note that the forms control table specified here must 
be created before this subsystem member is used for MSRJE. 



MSRJE READER ATTRIBUTES 


REBSCS1 



Remote system NBSRES Remote location LOCI 


1. Maximum number of MSRJE readers . 1-32 01 

2. Maximum number of host readers.1-7 01 

3. Transparency?.Y,N N 

4. Specify default value for TYPE . P/D,S P 

5. Specify default value for CMD.Y,N Y 

6. Specify default value for DEL.Y,N N 


Cmdl9-Cancel 
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Running MSRJE 


The following procedure command is used at System/36 to specify communications 
line 1 as being a nonswitched line: 

ALTERCOM 1,NONSWTCH 

The ENABLE command is used to start the subsystem and location on line 1. The 
subsystem name is REBSCSl, as defined on display 1.0 during subsystem member 
configuration. There is only one location (LOCI) in the subsystem member, and it 
is specified as being activated when the subsystem is enabled. 

ENABLE REBSCSl,RJELIB,1 

The MSRJE procedure command is entered to start MSRJE and to start the 
MSRJE console. Note that the location name (LOCI) is as defined on display 
30.0 during MSRJE subsystem configuration. 

MSRJE LOC1,,,,,,CONSOLE 

A second MSRJE procedure command is entered from another display station to 
start an MSRJE reader and to send a procedure member (REDGPRT) to the host 
system. Once the reader is started, the display station is released. Note that the 
library used is the current library, REDGPRT is a procedure member (the default 
specified for type on display 37.0 during MSRJE subsystem member configuration 
is P), and the member does not contain MSRJE utility control statements (the 
default for the CMD parameter is N, as specified on display 37.0 during subsystem 
member configuration). 

Print output is returned from the host system after the member has been sent. 
MSRJE LOC1,REDGPRT,,,,,RELEASE 

A third MSRJE procedure command is entered to start an MSRJE reader and to 
send a procedure member (REDGPUN) to the host system. Once the reader is 
started, the display station is released. Note that the library used is the current 
library, REDGPUN is a procedure member (the default specified for type on 
display 37.0 during MSRJE subsystem member configuration is P), and the 
member does not contain MSRJE utility control statements (the default for the 
CMD parameter is N, as specified on display 37.0 during subsystem member 
configuration). 

Punch output is returned from the host system after the member has been sent. 
MSRJE LOCI,REDGPUN,,,,,RELEASE 

After MSRJE processes the punch data, procedure TESTl in library RJELIB is 
started. You specify this procedure and library when updating the punch entry, 
FUl, in the forms control table. TESTl contains a LISTFILE procedure that lists 
the contents of the file you just created: 

LISTFILE ?2?,?1? 
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The following is the data that is sent to the host system when procedure member 
REDGPRT is read by MSRJE. 

//REDGPRT JOB ,Z 

//SI EXEC PGM=IEBDG,PARM='LINECNT=9999' 

//SYSPRINT DD SYSOUT=A 

//SYS0UT1 DD SYSOUT=(A,,FR1),DCB=(LRECL=133,BLKSIZE=133, 
RECFM=FBA) 

//SYSIN DD * 

DSD OUTPUT=(SYSOUT1) 

FD NAME=FIELD1,LENGTH=50,STARTLOC=1,PICTURE=50, 

'0100 RECORDS OF RJE PRINTER OUTPUT - ' 

FD NAME=FIELD2,LENGTH=51,STARTLOC=51,PICTURE=51, 

'SPECIAL FORM = FR1 -THIS IS RECORD NUMBER ' 

FD NAME=FIELD3,LENGTH=04,STARTLOC=102,FORMAT=ZD, 
INDEX=1 

CREATE QUANTITY=0100,NAME=(FIELD1,FIELD2,FIELD3) 

END 

/* 

// 

The fourth record in the member 

//SYSOUT1 DD SYSOUT={A,,FR1),DCB=(LRECL=133,BLKSIZE=133, 
RECFM=FBA) 

specifies the forms name that will be returned to System/36 (FRl). The forms 
control table (FCT) specified on display 36.0 during subsystem member 
configuration is searched for an entry name FRl when the output is returned. 
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The following is the data that is sent to the host system when procedure member 
REDGPUN is read by MSRJE. 


//REDGPUN JOB ,Z 
//SI EXEC PGM=IEBDG 
//SYSPRINT DD SYSOUT=A 

//SYSOUT1 DD SYSOUT=(B,,FU1),DCB=(LRECL=80,BLKSIZE=80, 
RECFM=FB) 

//SYSIN DD * 

DSD OUTPUT=(SYSOUT1) 

FD NAME=FIELD1,LENGTH=35,STARTLOC=1,PICTURE=35, 
'0100 RECORDS OF PUNCH OUTPUT — SPE' 

FD NAME=FIELD2,LENGTH=41,STARTLOC=36,PICTURE=41, 
'CIAL FORM = FU1 — THIS IS RECORD NUMBER ' 

FD NAME=FIELD3,LENGTH=04,STARTLOC=77,FORMAT=ZD, 
INDEX=1 

CREATE QUANTITY=0100,NAME=(FIELD1,FIELD2,FIELD3) 

END 


/* 

// 


The fourth record in the member 

//SYSOUT1 DD SYSOUT={B,,FU1),DCB=(LRECL=80,BLKSIZE=80, 
RECFM=FBA) 

specifies the forms name that will be returned to System/36 (FUl). The forms 
control table (FCT) specified on display 36.0 during subsystem member 
configuration is searched for an entry named FUl when the output is returned. 


The following is the procedure (MRJEPROC) at the host system (in 
SYSl.PROCLIB) that is executed when System/36 logs on to the host system. 

This is the same procedure as specified for the PROC parameter in the LOGON 
command on display 34.0 during subsystem member configuration. 

// 

SF ,RD1 
SF ,RD2 
SF ,RD3 
SF ,PU1 
SF ,PR1 
MN JOBNAMES,T 

Note that host readers RD2 and RD3 are not used by MSRJE because display 37.0 
specifies one host reader. 


C-12 Multiple Session Remote Job Entry Guide 



System/36 MSRJE to RES (SNA) 


This example illustrates using System/36 MSRJE to communicate with a SNA host 
system that is running RES under OS/VSl. Communications will occur over a 
nonswitched communications line. 

Line Member Configuration 

The following displays show the attributes specified for the SNA line member, 
which is named RESNALl and is in library RJELIB. 

Note: If you are interested in an example of an SNA/X.25 line member 
configuration see the System Reference manual. 


r 


1.0 


SSP-ICF CONFIGURATION MEMBER DEFINITION 



1. Configuration member name . RESNALl 

2. Library name.RJELIB 


3. Select one of the following: 

1 Create new member 

2. Edit existing member 

3. Create new member from existing member 

4. Remove a member 

5. Review a member 

Option.1-5 1 


Cmd7-End Cmdl9-Cancel 

Help text available throughout CNFIGICF by pressing the nelp key 



The name (RESNALl) entered for prompt 1 is referenced on display 21.0 during 
subsystem member configuration. 
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2.0 SSP-ICF CONFIGURATION MEMBER TYPE REBSCL1 W1 ’ 

Select one of the following options: 

1. INTRA 

2. BSC 

3. SNA 

4. ASYNC 

Option 2 


Cmd3-I>revious display Cmdl9-Cancel 

COPR IBM Corp. 1986 
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4.0 SNA CONFIGURATION MEMBER TYPE RESNALI W1 

1 . SNA member type. 1/2,3 2 


1. SNA subsystem member 

2. SNA/SDLC line member 

3. SNA/X.25 line member 


2. Will APPC be used ? 


Y,N 


N 


Cmd19-Cancel 

COPR IBM Corp. 1986 


12.0 SNA LINE MEMBER ATTRIBUTES RESNALI W1 

1 . Data link protocol.2 

1-Primary 2-Secondary 

2. Line type. 1 


1-Nonswitched 2-Switched 3-X.21 Short hold mode 


Cmdl9-Cancel 
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SNA LINE MEMBER ATTRIBUTES 


RESNAL1 


1 . Data link protocol.. . 2 

1-Primary 2-Secondary 

2. Line type .1 

1-Nonswitched 2-Switched 3-X.21 short hold mode 


W1 


5. Local system's station address . 01-FE Cl 

6. Local system's station XID in hexadecimal . 00FC1 


Cmdl9-Cancel 
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The name (RES) entered for prompt 1 is referenced during subsystem member 
configuration on display 29.0. After the Enter key is pressed, another prompt is 
added to display 13.0: 
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Display 14.0 defines the logical unit sessions that are to be used by MSRJE. 
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Subsystem Member Configuration 


The following displays show the attributes specified for the SNA subsystem 
member, which is named RESNASl and is in library RJELIB. 



SSP-ICF CONFIGURATION MEMBER DEFINITION 


1. Configuration member name . 

2. Library name . 

3. Select one of the following; 

1. Create new member 

2. Edit existing member 

3. Create new member from existing member 

4. Remove a member 

5. Review a member 

Option . 


Cmd7-End Cmdl9-Cancel 



W1 


RESNAS1 
RJELIB 


1-5 1 


Note that the library specified for prompt 2 must be the same library in which the 
associated line member (RESNALl) is stored. 
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4.0 


SNA CONFIGURATION MEMBER TYPE 


RESNAS1 


1. SNA member type . 

1. SNA subsystem member 

2. SNA/SDLC line member 

3. SNA/X.25 line member 


1,2,3 1 


Cmdl9-Cancel 

COPR IBM Corp. 1986 





21 .0 


SNA SUBSYSTEM MEMBER SELECTION 


RESNAS1 1 


1 . Line member name.RESNAL1 

2. Select subsystem type from the following options: 

1. Peer 

2. SNA Upline 

3. SNA 3270 

4. Finance 

5. SNA MSRJE 

6. APPC 

Option.1-6 5 


Cmd3-Previous display 



Cmd19~Cancel 


The line member name was specified on display 1.0 during line member 
configuration. 
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The remote system in the line member is RES, as specified on display 11.0 during 
line member configuration. 



The value (RES) is carried over from display 29.0, and was originally defined on 
display 11.0 during line member configuration. The location name (LOCI) is the 
value used in the MSRJE procedure command to start a session with this location. 
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The value (FSPROC) specified for the PROC parameter of the LOGON command 
identifies a procedure at the host system that is to be started when System/3 6 logs 
on to the host system. The procedure is stored in SYSl.PROCLIB. 
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The forms control table (FCT) is described under “Creating the Forms Control 
Table” later in this appendix. Note that the forms control table specified here must 
be created before this subsystem member is used for MSRJE. 
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Running MSRJE 


The following procedure command is used at System/36 to specify communications 
line 1 as being a nonswitched line: 

ALTERCOM 1,NONSWTCH 

The ENABLE command is used to start the subsystem and location on line 1. The 
subsystem name is RESNASl, as defined on display 1.0 during subsystem member 
configuration. There is only one location (LOCI) in the subsystem member, and it 
is specified as being activated when the subsystem is enabled. 

ENABLE RESNAS1,RJELIB,1 

The MSRJE procedure command is entered to start MSRJE and to start the 
MSRJE console. Note that the location name (LOCI) is as defined on display 
30.0 during MSRJE subsystem configuration. 

MSRJE LOC1 ,,,r ,,CONSOLE 

A second MSRJE procedure command is entered from another display station to 
start an MSRJE reader and to send a procedure member (REDGPRT) to the host 
system. Once the reader is started, the display station is released. Note that the 
library used is the current library, REDGPRT is a procedure member (the default 
specified for type on display 37.0 during MSRJE subsystem member configuration 
is P), and the member does not contain MSRJE utility control statements (the 
default for the CMD parameter is N, as specified on display 37.0 during subsystem 
member configuration). 

Print output is returned from the host system after the member has been sent. 
MSRJE LOC1,REDGPRT,,,,,RELEASE 

A third MSRJE procedure command is entered to start an MSRJE reader and to 
send a procedure member (REDGPUN) to the host system. Once the reader is 
started, the display station is released. Note that the library used is the current 
library, REDGPUN is a procedure member (the default specified for type on 
display 37.0 during MSRJE subsystem member configuration is P), and the 
member does not contain MSRJE utility control statements (the default for the 
CMD parameter is N, as specified on display 37.0 during subsystem member 
configuration). 

Punch output is returned from the host system after the member has been sent. 
MSRJE LOC1,REDGPUN,,,,,RELEASE 

After MSRJE processes the punch data, procedure TESTl in library RJELIB is 
started. You specify this procedure and library when updating the punch entry, 
FUl, in the forms control table, TESTl contains a LISTFILE procedure that lists 
the contents of the file you just created: 

LISTFILE ?2?,?1? 
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The following is the data that is sent to the host system when procedure member 
REDGPRT is read by MSRJE. 

//REDGPRT JOB ,Z 

//SI EXEC PGM=IEBDG,PARM='LINECNT=9999' 

//SYSPRINT DD SYSOUT=A 

//SYSOUT1 DD SYSOUT=(A,,FR1),DCB=(LRECL=133,BLKSIZE=133, 
RECFM=FBA) 

//SYSIN DD * 

DSD OUTPUT=(SYSOUT1 ) 

FD NAME=FIELD1,LENGTH=50,STARTL0C=1,PICTURE=50, 

'0100 RECORDS OF RJE PRINTER OUTPUT - ' 

FD NAME=FIELD2,LENGTH=51,STARTLOC=51,PICTURE=51, 

'SPECIAL FORM = FR1 -THIS IS RECORD NUMBER ' 

FD NAME=FIELD3,LENGTH=04,STARTLOC=102,FORMAT=ZD, 

INDEX=1 

CREATE QUANTITY=0100,NAME=(FIELD1,FIELD2,FIELD3) 

END 

/* 

// 


The fourth record in the member 

//SYSOUT1 DD SYSOUT={A,,FR1),DCB=(LRECL=133,BLKSIZE=133, 
RECFM=FBA) 

specifies the forms name that will be returned to System/36 (FRl). The forms 
control table (FCT) specified on display 36.0 during subsystem member 
configuration is searched for an entry name FRl when the output is returned. 


The following is the data that is sent to the host system when procedure member 
REDGPUN is read by MSRJE. 

//REDGPUN JOB ,Z 
//SI EXEC PGM=IEBDG 
//SYSPRINT DD SYSOUT=A 

//SYSOUT1 DD SYSOUT=(B,,FU1),DCB=(LRECL=80,BLKSIZE=80, 
RECFM=FB) 

//SYSIN DD * 

DSD OUTPUT=(SYSOUT1) 

FD NAME=FIELD1,LENGTH=35,STARTLOC=1,PICTURE=35, 
'0100 RECORDS OF PUNCH OUTPUT — SPE' 

FD NAME=FIELD2,LENGTH=41,STARTLOC=36,PICTURE=41, 
'CIAL FORM = FU1 — THIS IS RECORD NUMBER ' 

FD NAME=FIELD3,LENGTH=04,STARTLOC=77,FORMAT=ZD, 
INDEX=1 

CREATE QUANTITY=0100,NAME=(FIELD1,FIELD2,FIELD3) 

END 

/* 

// 

The fourth record in the member 

//SYSOUTI DD SYSOUT=(B,,FU1),DCB=(LRECL=80,BLKSIZE=80, 
RECFM=FBA) 

specifies the forms name that will be returned to System/36 (FUl). The forms 
control table (FCT) specified on display 36.0 during subsystem member 
configuration is searched for an entry named FUl when the output is returned. 
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The following is the procedure (FSPROC) at the host system (in SYSl.PROCLIB) 
that is executed when System/36 logs on to the host system. This is the same 
procedure as specified for the PROC parameter in the LOGON command on 
display 34.0 during subsystem member configuration. 

// 

SF ,RD1 
SF ,PR1 
MN JOBNAMES^T 

Note that the host punch (PUl) is not started by this procedure. It must be started 
by the RJE operator before punch output can be received. 
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Creating the Forms Control Table 


The control table created here is used to control the destination of output received 
from the host system. It is named FCT and is used in both the BSC and SNA 
examples. 



MSRJE CONTROL TABLE UTILITY 
Work with control tables 


Select one of the following: 

1. Create a new table 

2. Update entries in an existing table 

3. Add entries to an existing table 

4. Remove entries from an existing table 

5. Remove a table 

6. Print entries from an existing table 

7. Print a table 

8. Review entries in an existing table 

9. End the control table utility 

Option . 


Optional-* 


1 


Table name . 

Preferred disk location 
Cmd7-End of job 



FCT 


. A1,A2,A3,A4,block number A1 * 

Cmd2-Page back 

CORP IBM Corp. 1986 


The name of the table (FCT) is referenced by prompt 1 on display 36.0 during 
subsystem member configuration. 


MSRJE CONTROL TABLE UTILITY 


Create a control table entry 


Select a type of entry to work with: 

1. Print 

2. Print default 

3. Punch 

4. Punch default 

Option . 


FCT 



Table entry name 


FR1 


Cmd3-Save entry, display table menu 


Cmd7-Save table, end of job 

COPR IBM Corp. 1986 
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The entry name matches the host forms name used for print output in the BSC and 
SNA examples. 


MSRJE CONTROL TABLE UTILITY 
Create a control table entry 


FCT 

FR1 


Select where the output is to go: 

1. Printer 

2. Disk file 

3. Disk file with carriage information 

4. Compressed disk file for a printer 

5. Compressed disk file for a disk file 

6. Compressed disk file for a disk file with carriage information 


Option 


1 




Cmd7-Save table, end of job 

COPR IBM Corp. 1986 


r 


MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table print entry 



Use host printer balancing 


N,Y N 


Cmd3-Save entry, display entry menu 



Cmd7-End of job, cancel entry 

COPR IBM Corp. 1986 
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The entry name matches the host forms name used for print output in the BSC and 
SNA examples. 


MSRJE CONTROL TABLE UTILITY FCT 

FR1 

Create an MSRJE forms control table print entry 

Optional-* 

Local forms name.LFR1 * 

Printer ID or SYSTEM . SYSTEM 

Align the forms before printing? . N,Y N 

Spool?.Y,N Y 

Final quality printing? . N,Y N 

Issue end of forms message?.Y,N Y 

Select a printwheel ID for the printer?.N,Y N 

Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1985 IBM Corp. 


MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table print entry 


Optional-* 


Lines per inch ..4,6,8 

Characters per inch.10,15 

Lines per page.1-112 68 

Line number of the last line per page.1-112 68 

Line skips for forms: 


01 - 

1 

02 - 

0 

03 - 

0 

04 - 

0 

05 - 

0 

06 - 

0 

07 - 

0 

08 - 

0 

09 - 

0 

10 - 

0 

11 - 

0 

12 - 

0 


Cmd3-Save entry, display entry menu 


Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 
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MSRJE CONTROL TABLE UTILITY FCT 

FR1 

Create an MSRJE forms control table print entry 

Optional-^ 

Hold in the spool file after printing?.N,Y N 

Begin printing when the job step ends?.Y,N Y 

Continue printing the same job stream?.N,Y N 

Number of copies to be printed. 1-255 1 ♦ 

Priority on the spool file.0-5 1 

Expected activity of spooled print file . N,H,L,M N 


Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 
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MSRJE CONTROL TABLE UTILITY 


FCT 


Create a control table entry 


Select a type of entry to work with: 

1. Print 

2. Print default 

3. Punch 

4. Punch default 

Option . 3 


Table entry name 


Cmd3-Save entry, display table menu Cmd7-Save table, end of job 


COPR IBM Corp. 1986 


MSRJE CONTROL TABLE UTILITY 


Create a control table entry 


Select where the output is to go: 

1. Printer 

2. Disk file 

3. Disk file with carriage information 

4. Compressed disk file for a printer 

5. Compressed disk file for a disk file 

6. Compressed disk file for a disk file with carriage information 

Option . 1 


Cmd3-Save table, display table menu Cmd7-Save table, end of job 


COPR IBM Corp. 1986^ 
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MSRJE CONTROL TABLE UTILITY 


FCT 

FU1 


Create an MSRJE forms control table punch entry 

Optional-* 


Name of the file to be created . . 

User ID . 

Procedure name . 

Library name . 

Type of file to be created .... 
Save the file in case of error? 

Add output to an existing file? 

Free unused file blocks? . 

Cmd3~Save entry, display entry menu 



. . . LFU1 

.HOST 

. TEST1 * 

. RJELIB ’ 

. S,D,I S 

.Y,N Y 

.N,Y N 

.Y,N Y 

Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 




MSRJE CONTROL TABLE UTILITY 
Create an MSRJE forms control table punch entry 



Optional-* 


Number of blocks to be reserved 
Number of blocks to extend the file 

Preferred disk location . 

Record length in bytes . 

Delete capable file? . 


. 1-312815 60 

. 0-312815 10 

A1,A2,A3,A4,block number A1 

. 1-4096 80 

.N,Y N 


Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp, 
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Appendix D. Forms Control Table Default Entries 


Whenever you create an MSRJE forms control table, the forms control utility 
automatically places two entries in the table. One of these entries is used for print 
output when no entry in the table matches the received host forms name, and the 
other entry is used for punch output received when no entry in the table matches 
the received host forms name. 

If you do not specify a forms control table on display 36.0 during subsystem 
member configuration, the IBM-supplied values for print and punch default entries 
are used. As supplied, the default print entry causes received printer data to be 
printed; received punch data is written to a disk file. 


IBM'Supplied Print and Punch Default Values 


IBM-Supplied Print Default Entry 

The following displays show the values used for the IBM-supplied print default 
entry. The received print data is printed. 


MSRJE CONTROL TABLE UTILITY 


Update a control table entry 


Select a type of entry to work with: 

1. Print 

2. Print default 

3. Punch 

4. Punch default 

Option . 

Table entry name ..... . 


2 




Cmd7-Save table, end of job 

COPR IBM Corp. 1986 
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MSRJE CONTROL TABLE UTILITY FORMFILE 

Update a control table entry 


Select where the output is to go: 

1. Printer 

2. Disk file 

3. Disk file with carriage information 

4. Compressed disk file for a printer 

5. Compressed disk file for a disk file 

6. Compressed disk file for a disk file with carriage information 

Option . ...... . 1 


Cmd3-Save table, display table menu 



Cmd7-Save table, end of job 

COPR IBM Corp, 1986 


MSRJE CONTROL TABLE UTILITY 
Update an MSRJE forms control table entry 
Use host printer balancing...N,Y N 


FORMFILE 


Cmd3-Save table, display entry menu Cmd7-End of job, cancel entry 



COPR IBM Corp. 


1986 
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MSRJE CONTROL TABLE UTILITY 
Update an MSRJE forms control table print entry 


FOR^IFILE 

Optional-* 


Local forms name. ♦ 

Printer ID or SYSTEM . SYSTEM 

Align the forms before printing? . N,Y N 

Spool?.Y,N Y 

Final quality printing? . N,Y N 

Issue end of forms message?.Y,N Y 

Select a printwheel ID for the printer?. .N,Y N 

Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1985 IBM Corp. 


MSRJE CONTROL TABLE UTILITY 
Update an MSRJE forms control table print entry 

Lines per inch.4,6,8 

Characters per inch. 10,15 

Lines per page. 1-112 

Line number of the last line per page . . . . . , . . . 1-112 

Line skips for forms: 


Optional- 


01 - 

1 

02 - 

0 

03 - 

0 

04 - 

0 

05 - 

0 

06 - 

0 

07 - 

0 

08 - 

0 

09 - 

0 

10 - 

0 

11 - 

0 

12 - 

0 


Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 


Appendix D. Forms Control Table Default Entries D-3 













MSRJE CONTROL TABLE UTILITY 


FORMFILE 


Update an MSRJE forms control table print entry 


Optional-* 

Hold in the spool file after printing?.N,Y N 

Begin printing when the job step ends?.Y,N Y 

Continue printing the same job stream?.N,Y N 

Number of copies to be printed . 1-255 * 

Priority on the spool file.0-5 1 

Expected activity of spooled print file . N,H,L,M N 


Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp 



MSRJE CONTROL TABLE UTILITY 
Update a control table entry 

Update the compressed disk file information? . N,Y N 


FORMFILE 


Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1985 IBM Corp 

V_ _ 
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IBM-Supplied Punch Default Entry 


The following displays show the values used for the IBM-supplied punch default 
entry. The received punch data is written to a disk file. 



MSRJE CONTROL TABLE UTILITY 
Update a control table entry 


Select where the output is to go: 

1. Printer 

2. Disk file 

3. Disk file with carriage information 

4. Compressed disk file for a printer 

5. Compressed disk file for a disk file 

6. Compressed disk file for a disk file with carriage information 



Option 


Cmd3-Save table, display table menu 


Cmd7-Save table, end of job 

COPR IBM Corp. 1986 
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MSRJE CONTROL TABLE UTILITY FORMFILE 

Update an MSRJE forms control table punch entry 

Optional-* 

Name of the file to be created.MSRJE 

User ID...MSRJE 

Procedure name . .. * 

Library name.#LIBRARY 

Type of file to be created.S,D,I S 

Save the file in case of error?.Y,N Y 

Add output to an existing file?.N,Y N 

Free unused file blocks?.Y,N Y 

Cmd3-Save entry, display entry menu CmdV-End of job, cancel entry 

(c) 1983 IBM Corp. 


MSRJE CONTROL TABLE UTILITY 
Update an MSRJE forms control tabie punch entry 

Number of blocks to be reserved . 1-560872 

Number of blocks to extend the file. 0-560872 

Preferred disk location . A1,A2,A3,A4,block number A1 

Record length in bytes . 1-4096 { 

Delete capable file? . N,Y N 


FORMFILE 


60 

10 


Cmd3-Save entry, display entry menu 


Cmd7-End of job, cancel entry 

COPR IBM Corp. 1986 
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Changing the Default Entries 


You can change the default entries by using the update entry option (option 2 on 
the Control Table display). The name of a default entry is always 8 blanks. 

Changing the Destination in a Print Default Entry 

The IBM-supplied print default entry directs output to the printer. If you change 
the destination to a compressed disk file for a printer, but do not change the values 
within the entry, the following values are used: 


I 


MSRJE CONTROL TABLE UTILITY 


Update a control table entry 


Select a type of entry to work with: 

1. Print 

2. Print default 

3. Punch 

4. Punch default 

Option . 

Table entry name . 


Cmd3-Save table, display table menu 



Cmd7-Save table, end of job 

COPR IBM Corp. 1986 



MSRJE CONTROL TABLE UTILITY 
Update a control table entry 


Select where the output is to go: 

1. Printer 

2. Disk file 

3. Disk file with carriage information 

4. Compressed disk file for a printer 

5. Compressed disk file for a disk file 

6. Compressed disk file for a disk file with carriage information 

Option . 4 


Cmd3-Save table, display table menu 



Cmd7-Save table, end of job 

COPR IBM Corp. 1986 
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MSRJE CONTROL TABLE UTILITY 
Update an MSRJE forms control table print entry 

Lines per inch.4,6,8 

Characters per inch.10,15 


Lines per page . 

Line number of the last line per page 
Line skips for forms: 


Optional- 


01 - 

1 

02 - 

0 

03 - 

0 

04 

05 - 

0 

06 - 

0 

07 - 

0 

08 

09 - 

0 

10 - 

0 

11 - 

0 

12 


Cmd3-Save entry, save entry menu 


Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 


MSRJE CONTROL TABLE UTILITY FORMFI 

Update an MSRJE forms control table print entry 

Optional- 

Hold in the spool file after printing?.N,Y N 

Begin printing when the job step ends?.Y,N Y 

Continue printing the same job stream?.N,Y N 

Number of copies to be printed.1-255 

Priority on the spool file ..0-5 1 

Expected activity of spooled print file . N,H,L,M N 


Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 
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Changing the Destination in a Punch Default Entry 


The IBM-supplied print default entry directs output to a disk file. If you change 
the destination to a compressed disk file for a disk file, but do not change the 
values within the entry, the following values are used: 
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MSRJE CONTROL TABLE UTILITY 


FORMEILE 


Update a control table entry 


Select where the output is to go: 

1. Printer 

2. Disk file 

3. Disk file with carriage information 

4. Compressed disk file for a printer 

5. Compressed disk file for a disk file 

6. Compressed disk file for a disk file with carriage information 

Option . 5 


Cmd3-Save table, display table menu Cmd7-Save table, end of job 


COPR IBM Corp. 1986 


MSRJE CONTROL TABLE UTILITY 


Update an MSRJE forms control table compressed disk file entry 


Optional-* 


Name of the file to be created 


Number of blocks to be reserved 


Number of blocks to extend the file 


Preferred disk location 


A1,A2,A3,A4,block number A1 


Save the file in case of error? 


Add output to an existing file?.N,Y N 

Free unused file blocks?.Y,N Y 

Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 


COPR IBM Corp. 1986 
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MSRJE CONTROL TABLE UTILITY 


FORMEILE 


Update an MSRJE forms control table punch entry 


Optional-* 

Name of the file to be created.MSRJE 

User ID.MSRJE 

Procedure name. * 

Library name . #LIBRARY 


Type of file to be created. S,D,IS I 

Save the file in case of error?.Y,N Y 

Add output to an existing file?.N,Y N 

Free unused file blocks?.Y,N Y 

Cmd3-Save entry, display entry menu Cmd7-End of job, cancel entry 

(c) 1983 IBM Corp. 

_ _ J 
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Appendix E. Establishing a Communications Link 


The following forms show an example of the procedure that should be followed to 
initiate MSRJE communications on a switched line. The example is for a manual 
answer BSC line (System/36 line number 1). 

The subsystem that is to be used is called BSC and is stored in library 
COMMLIBR. MSRJE uses remote location BSCLOC in the subsystem member. 

In the example, the operator signs on to MSRJE as the console and specifies a disk 
file to be used as reader input. 

It is recommended that these forms (which can be found in the Operating Your 
Computer) be filled out for each communications application that uses a switched 
line. 
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USING MULTIPLE SESSION REMOTE JOB ENTRY 


To Establish the Communications Link 


b. SYS-3401 SDLC (line number) Operator 
dial is required . . . 


1. At a display station, perform the following steps: 

Enter ALTERCOM 1,SWITCHED,MA _ This message is displayed because you have an 

Enter ENABLE BSC,COMMLIBR,1 _ SDLC switched line, and you must call a remote 

Enter MSRJE BSCLOC,SENDREC,, location. Perform the following steps: 

DISK,,,CONSOLE _ _ 


2. At the system console, one of the following messages 
may be displayed: 


a. RJE-4631 Line (line number) Operator 
dial is required . . . 


c. RJE-4632 Line (line number) Operator 
answer is required . . . 


This message is displayed because you have a BSC 
switched line, and you must call a remote location. 
Perform the following steps: 


option 0. _ 

When the telephone rings, answer it. 
Press the data button on the telephone. 
Replace the handset. _ 


S7909006-0 


This message is displayed because you have a BSC 
switched line, and you must answer a call from a 
remote location. Perform the following steps: 

Respond to the message with _ 


V 
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d. SYS-3400 SDLC (line number) Operator To End the Communications Link 

answer is required . . . 

Perform the following steps: 

This message is displayed because you have an After receivinQ job PAYROLL 

SDLC switched line, and you must answer a call 
from a remote location. Perform the following steps: 


enter DISABLE BSC. 



e. Other message 

See the System Messages manual for an explanation 
of the message and the steps that you should follow. 

S7909007-0 


enter, , HEND . _ 

When MSRJE is ended. 
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Appendix F. MSRJE Problem Determination 


This appendix contains a problem determination procedure that can help you find 
the cause of an MSRJE problem. 


MSRJE Problem Determination Procedure 

The following procedure helps you to determine whether the MSRJE feature, 
improper operation, or an incorrect configuration value is causing the problem. 

The procedure either tells you how to correct the problem or tells you who to call 
at the host system for assistance. If a problem continues to occur, the procedure 
directs you to call for service. In most cases, you would be calling for your 
System/36 programming service representative. 

Note: If you correct a problem as requested by the following procedure and another 
problem occurs, go back to step 1, discard any previously printed displays, and 
go through the procedure again using the new symptom. If the problem cannot 
be corrected by the procedure, you should refer to ''Calling for Service'* (at the 
end of this appendix), collect the information described there, and then call 
your service representative. 
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1. Are there any Systeni/36 messages (messages preceded by the 4-digit 
identification code) associated with this job? 

These messages can be seen: 

- At your display, 

~ At the System/36 system console, or 

- In the System/36 history file. (Use the HISTORY procedure to 
look at the messages that have system console routing.) 

Yes No 

1 

Call and ask the host system operator: Are there any messages at 
the host system associated with this remote job entry? 

Yes No 

I 

Do the following: 

A. Use the D I command and the Print key to display and print 
MSRJE subsystem status. 

B. On the subsystem status display, locate the line number that 

is associated with your subsystem. Then use the D C command 
and the Print key to display and print the communications 
status for the communications line being used by MSRJE (for 
each communications line, there are three display segments). 

You should print the set of displays that is associated 
with the line shown on the D I display for your subsystem. 

C. Your MSRJE subsystem configuration is defined by values 
specified in both a subsystem member and a line member. 

Use the CNFIGICF procedure to display and print all the 
displays for both the subsystem member and line member 
that are being used by this subsystem configuration. 

-- The subsystem member name is the first parameter on the 
ENABLE procedure command. Enter this name for prompt 1 
of CNFIGICF display 1.0. Also, enter the right library 
name for prompt 2, and enter a 5 for prompt 3. 

— The location name is the first parameter on the MSRJE 
procedure command. Enter the location name on prompt 2 
of CNFIGICF display 30.0. 

— The line member name is shown on prompt 1 of CNFIGICF 
display 21.0, which is one of the subsystem member displays. 
Enter this name on prompt 1 of CNFIGICF display 1.0, and 
enter the library name for prompt 2 and a 5 for prompt 3. 

(See Chapter 2 for information about the CNFIGICF procedure.) 

You will use the above information in most of the following 
problem determination steps. Now go to step 2. 


(continued on next page) 
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Correct the problem indicated by the host system message and try 
the job again. If the problem indicated by the host system message 
continues to occur, call your service representative. 

See “Calling for Service” for more information. 

Correct the problem indicated by the message(s) and try the job 
again. Correct the problem using the MSRJE messages manual, the 
System Messages manual, and possibly the System Problem Determination 
manual. 

Were you able to solve the problem using the System/36 messages? 

Yes No 

I 

CaU and ask the host system operator: Are there any messages at 
the host system associated with this remote joh entry? 

Yes No 

Call your service representative. See “Calling for Service” 
for more information. 

Correct the problem indicated by the host system message and try 
the job again. If the problem indicated by the host system message 
continues to occur, call your service representative. 

See “Calling for Service” for more information. 

End of problem determination. 
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2. Is Startup in progress being displayed continuously (for at 
least 2 minutes)? 

Yes No 

I 

Does it appear that you are having console problems? 

For example, are you unable: to send host system console messages, 
to enter MSRJE console utility control statements, or to display 
host system console messages or MSRJE console messages? 

Yes No 

I 

Does it appear that you are having reader problems? 

For example, is Waiting for a reader. Reader Input, or 
READFILE in progress being displayed continuously (for at 
least 2 minutes)? 

Yes No 

I 

Does it appear that you are having printer or punch 
problems? For example, are you waiting for print or punch 
output, or was the received output handled incorrectly? 

Yes No 

I 

Are you having problems ending MSRJE? 

Yes No 

I 

End of problem determination; call your service 
representative. See ‘'Calling for Service’’ for more 
information. 

Go to step 12. 

Go to step 10. 

Go to step 9. 

Go to step 6. 

Go to step 3. 
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Are you using a switched line? 

Yes No 

I 

Go to step 4. 

Check display 10.0 (for BSC) or check displays 12.0 and 13.0 (for SNA) 
of the CNFIGICF displays you printed. 

Was autoanswer specified for the switched line? 

Yes No 

I 

Go to step 4. 

The host system or the host system operator must call System/36 to 
connect the communications line. Ask the host system operator to call. 

Has the problem been corrected? 

Yes No 

Does the modem support autoanswer? 

Yes No 

I 

If the modem does not support autoanswer, System/36 will not 
answer. Disable the MSRJE subsystem and use CNFIGICF to 
specify manual answer for this line (on display 10.0 for BSC 
or display 12.0 for SNA). Then enable the subsystem to make 
the change effective. 

Go to step 4. 

End of problem determination. 


Are you using BSC MSRJE? 

Yes No 

I 

Go to step 5. 

Call the host system operator and make sure that the communications 
line has been started. If the line has been started and the 
problem still occurs, call your service representative. See 
“Calling for Service” for more information. 
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5. Call the host system operator and ask if all of the following are 
active at the host system: 

A. The communications line 

B. The physical unit 

C. All the LUs (logical units) 

Yes No 

Ask the host system operator to vary the line, LU, and/or 
physical unit active. 

Check the following and make any necessary corrections: 

A. The NRZI parameter (found on the first display segment of the ’D H’ 
display for the line you are trying to use) must be specified with 

the same value that was specified on the LINE macro in the host 
system’s VTAM/NCP generation. If the value is not the same, use 
the SETCOMM procedure to change the NRZI parameter to match the 
value specified at the host system. 

B. The local system's station address specified during CNFIGICF 
(on display 13.0, prompt 5) must be the same as the address 
specified for the ADDR parameter on the PU macro in the host 
system’s VTAM/NCP generation. 

C. The LU (logical unit) assignments entered during CNFIGICF (on 
display 14.0) must be the same as those assigned during the host 
system’s VTAM/NCP generation. 

D. The number of LUs assigned for SNA MSRJE (that is, the number of Cs 
specified on display 14.0 of the line member being used for MSRJE) 
must be at least as large as the maximum number of sessions 

specified on display 34.0, prompt 4 for the MSRJE subsystem member 
being used. 

E. The minimum number of sessions specified during CNFIGICF (on 
display 34.0, prompt 5) must be varied active at the host system. 

Note: If you need to change a value for your MSRJE subsystem, you 

should disable the subsystem, make the required change(s), and then 
enable the subsystem to make the change effective. 

(continued on next page) 
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Were any corrections made to the items above? 


Yes No 

I 

If no changes were made to the items, either in your subsystem’s 
configuration or at the host system, call your service 
representative. See “Calling for Service” for more information. 

If the problem still occurs after you have made the corrections, you should 
return to step 1, discard any previously printed displays, and start again. 

Are you unable to send host system console messages, or are you 
unable to enter MSRJE console utility control statements? 

Yes No 

Are you unable to display host system console messages? 

Yes No 

1 

Are you unable to display MSRJE console messages? 

Yes No 

I 

End of problem determination; call your service 
representative. See “Calling for Service” for more 
information. 

Did you specify CONSOLE on the MSRJE procedure command? 
Yes yo 

You must specify CONSOLE to display MSRJE console 
messages; the console messages are in the history file. 

Call your service representative. See “Calling for Service” 
for more information. 

Go to step 8. 

Go to step 7. 
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7. Did you specify CONSOLE on the MSRJE procedure command? 

Yes No 

I 

You must specify CONSOLE to send console messages to the host 
system or to enter MSRJE console utility control statements. 

Press command key 7 to end this job. Reenter the MSRJE 
procedure command, specifying CONSOLE. 

Is Console Input displayed on line 21? 

Yes No 

I 

Press command key 1 to make Console Input appear on line 21 
of the display. Then you should be able to send host system console 
messages or enter MSRJE console utility control statements. 

Is the input inhibit indicator on continuously (for at least 2 minutes)? 

Yes No 

I 

End of problem determination; call your service representative. 

See “Calling for Service” for more information. 

For information about the input inhibit indicator, use the PROBLEM 
procedure to refer to the Online Problem Determination Aids. If 
that information does not help, then call your service representative. 

See “Calling for Service” for more information. 
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Did you specify CONSOLE on the MSRJE procedure conunand? 

Yes No 

I 

You must specify CONSOLE to display host system messages. If you 
did not, then the messages should be in the System/36 history file. 

Call and ask the host system programmer: Was the host system 
generated for console support? 

Yes No 

1 

If you want host system messages to be displayed, ask the host 
system programmer to specify console support in the host system’s 
generation. In the meantime, if these messages were sent 
as printer output, they should be on the MSRJE printer or in a 
disk file. 

Are you using SNA? 

Yes No 

1 

Call your service representative. See “Calling for Service” for 
more information. 

Are any readers, printers, or punches active? (Enter the 
D M command to display MSRJE status.) 

Yes No 

I 

Call your service representative. See “Calling for Service” for 
more information. 

All LUs (logical units) may be busy (this is more likely to occur if 
only one logical unit is assigned). Wait until a reader, printer, 
or punch is not busy. If you still do not receive any host 
system messages, call your service representative. See “Calling 
for Service” for more information. 
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9. Is Waiting for a reader being displayed continuously (for at least 
2 minutes)? 

Yes No 

I 

Is Reader Input being displayed continuously (for at least 2 minutes)? 

Yes No 

i 

Is READFILE in progress being displayed continuously (for at 
least 2 minutes)? 

Yes No 

I 

Are you waiting for a console message from the host system? 
Yes No 

i 

Are you waiting for printer or punch output? 

Yes No 

End of problem determination; call your service 
representative. See “Calling for Service” for more 
information. 

Go to step 10. 

Go to step 8. 

This is normal if a large file of data is being sent. If this 
is not a large file, and/or the reader does not end, call your 
service representative. See “Calling for Service” for more 
information. 

Did you enter an EOF statement, or did you press command key 7 or 19? 
Yes No 

I 

Enter another READFILE statement or, to end the reader, enter 
an EOF statement or press command key 7 or 19. 

Call your service representative. See “Calling for Service” 
for more information. 

Call and ask the host system operator or programmer to make sure: 

A. There are enough readers generated and available for use. 

B. There are enough LUs (logical units) assigned and/or started. 

C. The host readers are started. 

If actions A, B, and C do not solve the problem, call your service 
representative. See “Calling for Service” for more information. 
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10. You can get the information to answer the questions for this step by 

entering host system commands at the MSRJE console. If you do not know 
which commands to enter, you should call your host system operator. 

Are you waiting for print or punch output? 

Yes No 

1 

Go to step 11. 

Are there any jobs on the host system’s output queue? 

Yes No 

I 

Did you send a job using MSRJE? 

Yes No 

i 

You should send a job using MSRJE or, if the job should have 
been started at the host system, call the host system operator 
to ensure that it was started. If the job appears to have 
started but it is not producing any output, call and ask the 
host system programmer for assistance. 

Does the display station from which you sent the job have 
Console Input with Reader active displayed on line 21, 
or does it have Reader Input displayed on line 21? 

Yes No 

I 

Did you submit a valid job? 

Yes No 

1 

Submit a valid job and try again. 

The problem appears to be at the host system. Call and ask 
the host system operator or programmer for assistance. 

Do one of the following: 

A. If Console Input and Reader active are displayed, 

press command key 1 to display reader input, and then enter 
’.. EOF’. The job should now be sent to the host system. 

B. If /a2/7mMs displayed, enter’.. EOF’. The job 

should now be sent to the host system. 

Are the host system printers and/or punches started for your remote 
system? 

(continued on next page) 
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Yes No 

I 

Start the printers and/or punches, or ask the host system 
operator to start them. 

Is the output for your job being held at the host system? 

Yes No 

I 

Are the host printers and/or punches servicing the correct classes? 

Yes No 

I 

Change the device classes, or ask the host system operator to 
change them. 

Call and ask the host system programmer to verify that the numbers 
of printers and punches specified in the VTAM/NCP generation at 
the host system are the same as the numbers specified on CNFIGICF 
display 36.0, prompts 3 and 5. If these numbers are the same, call 
your service representative. See “Calling for Service” for more 
information. 

Release the job, or ask the host system operator to release it. 
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11. Did MSRJE handle your output correctly? 


Yes No 

1 

Is the forms name, specified in message RJE—4515, correct? 


Yes No 

I 

One of the following may he causing the problem: 

A. The host system was not generated to allow forms moun 
messages. 

B. For BSC, the format of the forms mount message is 
incorrect. The format of this message should be: 

RES: 

XX...IEF383AXX... (Where xx... is information not 
used to determine if it is a forms mount message.) 

JES2: 

XX.. .SETUP — Rxx... or xx...SETUP - Rxx... 

(Where xx... is information not used to determine 
if it is a forms mount message.) 

JES3: 

XX...IAT7030XX... (Where xx... is information not 
used to determine if it is a forms mount message.) 

RSCS: 

XX.. .PRINT MOUNTxx... (Where xx... is information 
not used to determine if it is a forms mount message.) 

C. For SNA, the peripheral data information record (PDIR) 
is not being used. 

D. The forms set number, as specified on CNFIGICF display 
36.0, is incorrect. 

Do any of the above situations exist? 

Yes No 

End of problem determination; call your service 
representative. See “Calling for Service” for 
more information. 

Make the necessary corrections. If a problem still occurs, 
return to step 1, discard any previously printed 
displays, and start again. 


(continued on next page) 
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One of the following, indicated by a message in the System/36 
history fUe, may be causing the problem: 

A. There is no forms control table. 

B. The forms control table name was not specified on CNFIGICF 
display 36.0. 

C. The forms control table cannot be used because of resource 
security. 

D. The forms control table cannot be shared. 

E. The forms control table was not created by RJTABLE. 

F. The specified entry was not found in the table. 

G. The specified entry is in the table, but it is not correct. 

Does a message in the history file indicate that any of the 
above situations exist? 

Yes No 

I 

End of problem determination; call your service 
representative. See “Calling for Service” for 
more information. 

Make the necessary corrections. Then if a problem still 
occurs, you should return to step 1, discard any 
previously printed displays, and start again. 

End of problem determination; call your service representative. See 
“Calling for Service” for more information. 
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12. Are you waiting for MSRJE to end? 

Yes No 

I 

Did MSRJE end unexpectedly? 

Yes No 

I 

End of problem determination. If you did not find the 
problem, call your service representative. See 
“Calling for Service” for more information. 

Was a nonblank termination delay value specified 
during CNFIGICF on prompt 2 of display 34.0? 

Yes No 

I 

Was an .. END utility control statement entered by 
an MSRJE reader? (Check the history file.) 

Yes No 

I 

Call your service representative. For more information, 
see “Calling for Service.” 

This is normal operation. If you want MSRJE to remain active, 
do not enter the .. END statement from the MSRJE reader. 

This is normal operation. If you want MSRJE to remain active, 
enter blanks for display 34.0, prompt 2. 

Was a host reader started? To determine this, call the 

host system operator or enter the appropriate host system console 

command. 

Yes No 

Use the appropriate host system commands to start a host reader. 

Are any MSRJE readers, printers, and/or punches active? 

(Enter the D M command to display MSRJE status.) 

Yes No 
Y Y 

(continued on next page) 
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Yes No 


Was the .. END utility control statement used? (Check the 
history file.) 

Yes No 

I 

Was a nonblank termination delay value specified on 
display 34.0 during CNFIGICF? 

Yes No 

I 

Enter a END’ utility control statement at the 
' MSRJE console. 

Is the MSRJE console active at any display station? 

(Enter the D M command to display MSRJE status.) 

Yes No 

I 

Wait for the specified delay time. Then, if MSRJE does 
not end, call your service representative. For more 
information, see “Calling for Service.” 

Either end the MSRJE console by pressing command key 7 or 
enter a END’ utility control statement. 

Was a delay specified with the .. END statement? 

Yes No 

I 

Call your service representative. See 
“Calling for Service” for more information. 

Wait for the specified delay time, or enter the ’.. END’ utility 
control statement without the DELAY parameter. 

Wait or cancel the readers and/or writers. 
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Calling for Service 


If you do the following before you call for service, you will help the service 
representative determine what the problem is and correct it as quickly as possible. 

1. If you are able to use the system keyboard, do the following: 

a. Run the APAR procedure or DUMP procedure to save a copy of the dump 
area for the service representative, if a dump was taken. (See the manual 
Procedures and Commands Summary and the manual System Problem 
Determination for information about these procedures.) 

b. Press the Print key to print the information that was displayed when the 
error occurred. 

c. Run the HISTORY procedure to save a copy of the history file for the 
service representative. (See the manual Procedures and Commands 
Summary for information about the HISTORY procedure.) 

d. Use the D C command and the Print key to display and print the 
communications line status for the line being used for this job. (There are 
three display segments for each communications line.) 

e. Use the D M command and the Print key to display and print the MSRJE 
status display. 

f. Use the CNFIGICF procedure and the Print key to display and print all the 
MSRJE CNFIGICF displays for your subsystem. (See step 1, item C of 
the problem determination procedure for how to get the MSRJE displays 
printed, and, if necessary, see Chapter 2 for information about 
CNFIGICF.) 

Save the information you collected in actions a through f to give to the service 

representative. 

2. Fill out a Problem Summary Form. On this form, you can record information 

about the system conditions at the time the error occurred. Copies of this form 

are contained in the System Problem Determination manual. 
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Glossary 


#LIBRARY. The library, provided with the system, that 
contains the System Support Program Product. See system 
library. 

abnormal termination. A system failure or operator action 
that causes a job to end unsuccessfully. 

access method. The way that records in files are referred 
to by the system. The reference can be consecutive 
(records are referred to one after another in the order in 
which they appear in the file), or it can be random (the 
individual records can be referred to in any order). 

access mode. See access method. 

acquire. To assign a display station or session to a 
program. 

adapter. See communications adapter. 

addressing. (1) In data communications, the way that the 
sending or control station selects the station to which it is 
sending data. (2) A means of identifying storage 
locations. 

advanced program-to-program communications (APPC). 

Communications support that allows System/36 to 
communicate with other systems having the same support. 
APPC is the way that System/36 puts the IBM SNA 
LU-6.2 protocol into effect. 

allocate. To assign a resource, such as a disk file or a 
diskette file, to perform a specific task. 

alphabetic character. Any one of the letters A through Z 
(uppercase and lowercase). Some program products 
extend the alphabet to include the special characters #, $, 
and @. 

alphameric. Consisting of letters, numbers, and often 
other symbols, such as punctuation marks and 
mathematical symbols. 

alphanumeric. See alphameric. 

I alternative index. An index that is built after a physical 
I file is created and that provides a different order for 
I reading or writing records in the file. Contrast with 
I primary index. 


alternative system console. A command display station 
that can be designated as the system console. 

American National Standard Code for Information 
Interchange (ASCII). The code developed by ANSI for 
information interchange among data processing systems, 
data communications systems, and associated equipment. 
The ASCII character set consists of 7-bit control 
characters and symbolic characters. 

American National Standards Institute (ANSI). An 
organization sponsored by the Computer and Business 
Equipment Manufacturers Association for establishing 
voluntary industry standards, 

ANSI. See American National Standards Institute (ANSI). 

APPC. See advanced program-to-program communications 
(APPC). 

application program. A program used to perform an 
application or part of an application. 

attribute. A characteristic. For example, an attribute for 
a displayed field could be blinking. 

autoanswer. In data communications, the ability of a 
station to receive a call over a switched line without 
operator action. Contrast with manual answer. 

autocall. In data communications, the ability of a station 
to place a call over a switched line without operator 
action. Contrast with manual call. 

autocall unit. A common carrier device that allows 
System/36 to automatically call a remote location. 

batch. Pertaining to activity involving little or no operator 
action. Contrast with interactive. 

batch BSC. The System Support Program Product 
support that provides data communications with BSC 
computers and devices via the RPG T specification or the 
assembler $DTFB macroinstruction. 

batch processing. A processing method in which a 
program or programs process records with little or no 
operator action. Contrast with interactive processing. 
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binary. (1) Pertaining to a system of numbers to the base 
two; the binary digits are 0 and 1. (2) Involving a choice 
of two conditions, such as on-off or yes-no. 

binary synchronous communications (BSC). A form of 
communications line control that uses transmission control 
characters to control the transfer of data over a 
communications line. Compare with synchronous data link 
control (SDLC). 

bind command. An SNA command used to define the 
protocols for a session. Contrast with unbind command. 

bit. Either of the binary digits 0 or 1. See also byte. 

block. (1) A group of records that is recorded or 
processed as a unit. Same as physical record. (2) Ten 
sectors (2560 bytes) of disk storage. (3) In data 
communications, a group of records that is recorded, 
processed, or sent as a unit. 

block check character. The character used in BSC to 
check that all of the bits transmitted were received. 

bps. Bits per second. 

BSC. See binary synchronous communications (BSC). 

BSCEL (binary synchronous communications equivalence 
link) subsystem. The SSP-ICF subsystem that provides 
BSC communications with another System/36 and many 
other BSC computers and devices. 

buffer. (1) A temporary storage unit, especially one that 
accepts information at one rate and delivers it at another 
rate. (2) An area of storage, temporarily reserved for 
performing input or output, into which data is read or 
from which data is written. 

byte. The amount of storage required to represent one 
character; a byte is 8 bits. 

C & SM. See Communications and Systems Management 
(C & SM). 

call. (1) To activate a program or procedure at its entry 
point. Compare with load. (2) In data communications, 
the action necessary in making a connection between two 
stations on a switched line. 

cancel. To end a task before it is completed. 

CCITT. Consultative Committee on International 
Telegraphy and Telephone. 

channel. A path along which data passes. 


channel control character. A value used by MSRJE to 
determine which line to skip to on a page before printing 
the next line of output. 

character. A letter, digit, or other symbol. 

character key. A keyboard key that allows the user to 
enter the character shown on the key. Compare with 
command key 2tn!di function key. 

characters per inch (CPI). The number of characters 
printed within an inch horizontally across a page. 

child. Pertaining to a secured resource, either a file or 
library, that uses the user list of a parent resource. A child 
resource can have only one parent resource. Contrast 
with parent. 

CICS subsystem. The SSP-ICF subsystem that allows 
binary synchronous communications with CICS/VS. 

CICS/VS. Customer Information Control System, which 
operates on a host system such as a System/370, or a 
30XX or 43XX processor. 

clocking. In data communications, a method of 
controlling the number of data bits sent on a 
communications line in a given time. 

close. To end the processing of a file. 

code. (1) Instructions for the computer. (2) To write 
instructions for the computer. Same as program. (3) A 
representation of a condition, such as an error code. 

collating sequence. The sequence in which characters are 
ordered within the computer for sorting, combining, or 
comparing. 

column separator. A symbol on each side of a position of 
a field on a display. This symbol does not occupy a 
position on the display. 

command. A request to the system to perform an 
operation or a procedure* 

command display. A display that allows an operator to 
display and send messages, and use control commands and 
procedure commands to start and control jobs. Contrast 
with standby display. See also console display and 
subconsole display. 

command display station. A display station from which an 
operator can start and control jobs. A command display 
station can become an alternative system console, can be 
designated as a subconsole, and can also be used as a data 
display station. See also alternative system console, data 
display station, and subconsole. 
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command file. In the MSRJE utility, a disk file, procedure 
member, or source member that can contain MSRJE 
utility control statements and records to be transmitted to 
the host system. Contrast with data file. 

I command key. A keyboard key that is used to request 
I specific programmed actions. Compare with character key 
I and function key. 

command processor. The part of the System Support 
Program Product that processes control commands and 
that passes procedure commands and operation control 
language statements to the initiator. 

I comment. Words or statements in a program or text or on 
I a display that serve as documentation rather than as 
I instructions, choices, or prompts. 

common carrier. In data communications, any 
government-regulated company that provides 
communication services to the general public. 

communications. See data communications. 

communications adapter. A hardware feature that enables 
a computer or device to become a part of a data 
communications network. 

I Communications and Systems Management (C & SM). A 
I feature of the System Support Program Product that 
I contains the remote management support (also referred to 
I as DHCF), the change management support (referred to 
I as DSNX), and the problem management support 
I (referred to as alerts). 

communications control program (CCP). An IBM 

System/3 Model 15 program that allows communications 
between System/3 and the SSP-ICF CCP subsystem. 

communications line. The line over which data 
communications takes place; for example, a telephone line. 

communications link. See data link. 

communications security. A System Support Program 
Product option that allows the identity of a remote 
location to be verified before that location can run 
programs on your system. 

communications subsystem. See subsystem. 

compression. In data communications, a technique for 
removing strings of duplicate characters and for removing 
trailing blanks before transmitting data. 

configuration. The group of machines, devices, and 
programs that make up a data processing system. See also 
system configuration. 


I configuration member. (1) A library member that 
I describes the devices, programming, and characteristics of 
I the system. (2) In data communications, a member that 
I defines the attributes of a communications subsystem or 
I line. 

configure. (1) To describe (to the system) the devices, 
optional features, and program products installed on a 
system. (2) To describe to SSP-ICF both the 
communications facilities connected to System/3 6 and the 
attributes of the subsystem and remote system. 

I console. A device used for communication between an 
I operator and the system. 

console display. A display that can be requested only at 
the system console. From a console display an operator 
can display, send, and reply to messages and use all 
control commands. 

constant. A data item with a value that does not change. 
Contrast with variable. 

control field. A field that identifies a record’s relationship 
to other records (such as a part number in an inventory 
record). In RPG, control fields are compared from record 
to record to determine when certain operations are to be 
performed. In sort, control fields determine the order of 
records in the sorted file. 

control storage. Storage in the computer that contains the 
programs used to control input and output operations and 
the use of main storage. Contrast with main storage. 

CPI. See characters per inch (CPI). 

current library. The first library searched for any required 
members. The current library can be specified during 
sign-on or while running programs and procedures. 

1 cursor. A movable symbol on a display, used to indicate 
I to the operator where to type the next character. 

data communications. The transmission of data between 
computers and/or remote devices (usually over a long 
distance). 

data display station. A display station from which an 
operator can only enter data. A data display station is 
acquired and controlled by a program. Contrast with 
command display station. 

data file. In the MSRJE utility, a disk file, procedure 
member, or source member that can contain only records 
to be transmitted to the host system. Contrast with 
command file. 

data item. A unit of information to be processed. 
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data link. The equipment and rules (protocols) used for 
sending and receiving data. 

data link escape (DLE) character. In BSC, a transmission 
control character usually used in transparent text mode to 
indicate that the next character is a transmission control 
character. 

I data management. See disk data management. 

data mode. In data communications, a time during which 
BSC is sending or receiving characters on the 
communications line. 

1 data set. A set of related print or punch records sent to 
1 MSRJE by the host. A job that produces output may 
I generate multiple data sets. In SNA MSRJE, data sets 
I may be preceded by a peripheral data set information 
I record (PDIR). 

data stream. All information (data and control 
information) transmitted over a data link. 

data terminal equipment (DTE). The data processing unit 
that uses communications lines. 

I date-differentiated files. Files with the same name that 
1 are distinguished by the dates they were created. 

DCE. See data circuit-terminating equipment (DCE). 

deactivate. To make ineffective. For example, to 
deactivate security. 

I decimal. (1) Pertaining to a system of numbers to the 
I base ten; decimal digits range from 0 through 9. (2) A 
I proper fraction in which the denominator is a power of 10. 

default. See default value. 

default value. A value stored in the system that is used 
when no other value is specified. 

delete. To remove. For example, to delete a file. 

delete-capable file. A file from which records can be 
logically removed without compressing the file. 

delimiter. A character or sequence of characters that 
marks the beginning or end of a unit of data. 

direct file. A disk file in which records are referenced by 
the relative record number. Contrast with indexed file and 
sequential file. 

disable. In interactive communications, to end a 
subsystem and free the area of main storage used by that 
subsystem. Contrast with enable. 


disk. A storage device made of one or more flat, circular 
plates with magnetic surfaces on which information can be 
stored. 

disk file. A set of related records on disk that is treated as 
a unit. See also record file and stream file. 

display. (1) A visual presentation of information on a 
display screen. (2) To show information on the display 
screen. 

display screen. The part of the display station on which 
information is displayed. 

display station. A device that includes a keyboard from 
which an operator can send information to the system and 
a display screen on which an operator can see the 
information sent to or the information received from the 
system. 

Distributed Systems Executive (DSX). A program product 
available for IBM host systems (System/370, 43XX, and 
30XX) that allows the host system to get, send, and 
remove files, programs, formats, and procedures in a 
network of computers. 

I Distributed Systems Node Executive (DSNX). Another 
I name for the change management support offered by the 
I Communications and Systems Management feature. This 
I support processes changes sent by a DSX host system. 

DSNX. See Distributed Systems Node Executive (DSNX). 

DSX. See Distributed Systems Executive (DSX). 

DTE. See data terminal equipment (DTE). 

EBCDIC. See extended binary-coded decimal interchange 
code (EBCDIC). 

EBCDIC character. Any one of the symbols included in 
the 8-bit EBCDIC set. 

EIA. Electronic Industries Association. 

eight-line communications adapter/attachment (ELCA). A 

feature that allows up to eight communication lines to be 
connected to a 5360 System Unit. 

ELCA. See eight-line communications adapter/attachment 
(ELCA). 

emulation. Imitation; for example, the imitation of a 
computer or device. 

enable. In interactive communications, to load and start a 
subsystem. Contrast with disable. 
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enter. To type in information from a keyboard and press 
the Enter key in order to send the information to the 
computer. 

exchange station ID. In SDLC, a control field command 
and/or response for passing station IDs between the 
primary station and a secondary station. 

extendable disk fOe. A file that the system can increase in 
size whenever more space is needed. 

extended binary-coded decimal interchange code 
(EBCDIC). A set of 256 eight-bit characters. 

I feature. A programming or hardware option, usually 
I available at an extra cost. For example, Communications 
I is a feature of the System Support Program Product. 

field. One or more characters of related information 
(such as a name or an amount). 

file. A set of related records treated as a unit. 

file name. The name used by a program to identify a file. 
See also label 

I folder. A named area on disk that contains documents, 

I profiles, mail, or data definitions. Compare with library. 

folder member. A named collection of statements in a 
folder. A document is an example of a folder member. 

format. (1) A defined arrangement of such things as 
characters, fields, and lines, usually used for displays, 
printouts, files, or documents. (2) To arrange such things 
as characters, fields, and lines. (3) In BASIC, a 
representation of the correct form of a command or 
statement. (4) In IDDU, a group of related fields, such as 
a record, in a file. 

function key. A keyboard key that requests an action but 
does not display or print a character. The cursor 
movement and Help keys are examples of function keys. 
Compare with command key and character key. 

handset. The part of a telephone used for talking and 
listening. 

I hard copy. A printed copy. Contrast with online. 

hardware. The equipment, as opposed to the 
programming, of a system. 

Help key. A function key that, when pressed, displays 
online information or some part of the system help 
support. 

I help text. The part of the system help support that offers 
I additional information about displays and messages. 


hex. See hexadecimal. 

hexadecimal. Pertaining to a system of numbers to the 
base sixteen; hexadecimal digits range from 0 (zero) 
through 9 (nine) and A (ten) through F (fifteen). 

history fUe. A file that contains a log of system actions 
and operator responses. 

horizontal tab table. A table used by MSRJE that contains 
values indicating the position on a line to skip to before 
printing. 

host system. The primary or controlling computer in a 
communications network. See also control station. 

I/O. See input/output (I/O). 

ID. Identification. 

index. (1) A table containing the key value and location 
of each record in an indexed file. (2) A computer storage 
position or register, the contents of which identify a 
particular element in a set of elements. 

informational message. A message that provides 
information to the operator, but does not require a 
response. 

initial program load (IPL). The process of loading the 
system programs and preparing the system to run jobs. 

initialize. To prepare for use. For example, to initialize a 
diskette. 

input. Data to be processed. 

input stream. The sequence of operation control 
statements and data given to the system from an input 
device. 

input/output (I/O). Pertaining to either input or output, 
or both. 

inquiry. (1) A request for information in storage. (2) A 
request that puts a display station into inquiry mode. (3) 
In data communications, a request for information from 
another system. 

inquiry mode. A mode during which the job currently 
running from a display station is interrupted so that other 
work can be done. The operator puts the display station 
in inquiry mode by pressing the Attn key. 

interactive. Pertaining to activity involving requests and 
replies as, for example, beiw^een an operator and a 
program or between two programs. Contrast with batch. 
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Interactive Communications Feature (SSP-ICF). A feature 
of the System Support Program Product that allows a 
program to interactively communicate with another 
program or system. 

interactive processing. A processing method in which each 
operator action causes a response from the program or the 
system. Contrast with batch processing. 

interrupt. (1) To temporarily stop a process. (2) In data 
communications, to take an action at a receiving station 
that causes the sending station to end a transmission. 

IPL. See initial program load (IPL). 

job. (1) A unit of work to be done by a system. (2) One 
or more related procedures or programs grouped into a 
procedure. 

job file. A disk file that exists until the job that uses it 
ends. 

job queue. A list of jobs waiting to be processed by the 
system. 

job step. A unit of work represented by a single program 
or a procedure that contains a single program. A job 
consists of one or more job steps. 

K“byte, 1024 bytes. 

key. One or more characters used to identify the record 
and establish the record’s order within an indexed file. 

keyword, A symbol that identifies a parameter. 

label. (1) The name in the disk or diskette volume table 
of contents or on a tape that identifies a file. See also file 
name. (2) The name that identifies a statement. 

library. (1) A named area on disk that can contain 
programs and related information (not files). A library 
consists of different sections, called library members. 
Compare with folder. (2) The set of publications for a 
system. 

library member. A named collection of records or 
statements in a library. The types of library members are 
load member, procedure member, source member, and 
subroutine member. 

load. (1) To move data or programs into storage. (2) To 
place a diskette into a diskette drive or a magazine into a 
diskette magazine drive. (3) To insert paper into a printer. 
(4) To mount a tape or insert a tape cartridge into a tape 
drive. 


load member. A library member that contains information 
in machine language, a form that the system can use 
directly. Contrast with source member. 

load module. A program in a form that can be loaded into 
main storage and run. The load module is the output of 
the overlay linkage editor. 

local. Pertaining to a device, file, or system that is 
accessed directly from your system, without the use of a 
communications line. Contrast with remote. 

location name. In interactive communications, the 
identifying name associated with a particular system or 
device. 

logical unit (LU). The part of a system or device in an 
SNA network that allows a user or program to use the 
communications network. 

LU. See logical unit (LU). 

main storage. The part of the processing unit where 
programs are run. Contrast with control storage. 

main storage processor. Hardware that performs the 
machine language instructions in main storage. 

manual answer. In data communications, a line type 
requiring operator actions to receive a call over a switched 
line. Contrast with autoanswer. 

manual call. In data communications, a line type requiring 
operator actions to place a call over a switched line. 
Contrast with autocall. 

menu. A displayed list of items from which an operator 
can make a selection. 

message identification. A field in the display or printout of 
a message that directs the user to the description of the 
message in a message guide or a reference manual. This 
field consists of up to four alphabetic characters, followed 
by a dash, followed by the message identification code. 

message identification code (MIC). A four-digit number 
that identifies a record in a message member. This 
number can be part of the message identification. 

MIC. See message identification code (MIC). 

MLCA. See multiline communications adapter/attachment 
(MLCA). 

modem. See modulator-demodulator (modem). 

1 modulate. To vary the frequency of. 
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modulation. Changing the frequency or size of one signal 
by using the frequency or size of another signal. 

modulator-demodulator (modem). A device that converts 
data from the computer to a signal that can be transmitted 
on a communications line, and converts the signal received 
to data for the computer. 

MSRJE. See Multiple Session Remote Job Entry 
(MSRJE). 

multiline communications adapter/attachment (MLCA). A 

feature that allows up to four communication lines to be 
connected to System/36. 

multiple. More than one. 

Multiple Session Remote Job Entry (MSRJE). A feature 
of the System Support Program Product that allows one or 
more remote job entry sessions to operate on a host 
system, such as a System/370, or a 30XX or 43XX 
processor, at the same time. 

multipoint. In data communications, pertains to a network 
that allows two or more stations to communicate with a 
single system on one line. 

negative response. In data communications, a reply 
indicating that data was not received correctly or that a 
command was incorrect or unacceptable. 

nest. To incorporate a structure or structures of some 
kind into a structure of the same kind. For example, to 
nest one loop (the nested loop) within another loop (the 
nesting loop); to nest one subroutine (the nested 
subroutine) within another subroutine (the nesting 
subroutine). 

network. A collection of data processing products 
connected by communications lines for information 
exchange between stations. 

non-return-to-zero inverted (NRZI). On System/36, a 
method of data transmission where the signal is changed 
to transmit a 0 bit. For the 1 bit the signal stays the same. 
This ensures that the signal does not stay the same for an 
extended period of time. 

nonswitched line. A connection between computers or 
devices that does not have to be established by dialing. 
Contrast with switched line. 

NRZI. See non-return-to-zero inverted (NRZI). 

null character. The character hex 00, used to represent 
the absence of a displayed or printed character. 

null character string. Two consecutive single quotation 
marks that specify a character constant of no characters. 


numeric. Pertaining to any of the digits 0 through 9. 

object program. A set of instructions in machine-runnable 
form. The object program is produced by a compiler from 
a source program. 

OCL. See operation control language (OCL). 

offline. Neither controlled directly by, nor communicating 
with, the computer, or both. Contrast with online. 

online. Being controlled directly by, or directly 
communicating with, the computer, or both. Contrast 
with offline. 

open. To prepare a file for processing. 

operand. A quantity of data that is operated on, or the 
address in a computer instruction of data to be operated 
on. 

operation control language (OCL). A language used to 
identify a job and its processing requirements to the 
System Support Program Product. 

output. The result of processing data. 

output stream. Messages and other output data, displayed 
on output devices by an operating system or a processing 
program. 

pad. To fill unused positions in a field with dummy data, 
usually zeros or blanks. 

parameter. A value supplied to a procedure or program 
that either is used as input or controls the actions of the 
procedure or program. 

parent. Pertaining to a secured resource, either a file or 
library, whose user list is shared with one or more other 
files or libraries. Contrast with child. 

password. A string of characters that, when entered along 
with a user ID, allows an operator to sign on to the 
system. 

password security. A System Support Program Product 
option that helps prevent the unauthorized use of a display 
station, by checking the password entered by each 
operator at sign-on. 

I PDIR. See peripheral data set information record (PDIR). 

I peripheral data set information record (PDIR). A record 
I sent to MSRJE by the host system to control the format of 
I printed or punched output. 

phone list. A list of telephone numbers to be called using 
a communications program and the autocall or X.25 
feature. 
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physical record. (1) A group of records that is recorded or 
processed as a unit. Same as block. (2) A unit of data 
that is moved into or out of the computer. 

point-to-point line. A communications line that connects 
a single remote station to a computer. 

poll. To execute a polling sequence. 

polling. A method for determining whether each of the 
stations on a communications line has data to send. 

port. A part of the system unit or remote controller to 
which cables for display stations and printers are attached. 

position. The location of a character in a series, as in a 
record, a displayed message, or a computer printout. 

positional parameter. A parameter that must appear in a 
specified location, relative to other positional parameters. 

primary index. The index that is built when a file is 
created. Contrast with alternative index. 

print image. A character set that corresponds to the 
characters on a print belt. 

1 print wheel. An interchangeable print element used in 
I certain printers. 

printout. Information from the computer that is produced 
by a printer. 

priority. The relative ranking of items. For example, a 
job with high priority will be run before one with regular 
or low priority. 

problem determination. The process of identifying why 
the system is not working. Often this process identifies 
programs, equipment, data communications facilities, or 
user errors as the source of the problem. 

procedure. A set of related operation control language 
statements (and, possibly, utility control statements and 
procedure control expressions) that cause a specific 
program or set of programs to be performed. 

procedure command. A command that runs a procedure. 

procedure member. A library member that contains the 
statements (such as operation control language 
statements) necessary to perform a program or set of 
programs. 

processing unit. The part of the system unit that performs 
instructions and contains main storage. 


program. (1) A sequence of instructions for a computer. 
See source program and load module. (2) To write a 
sequence of instructions for a computer. Same as code. 

program product. A licensed program for which a fee is 
charged. 

Programming Request for Price Quotation (PRPQ). A 
program created especially for a particular group of 
customers or an application. Documentation for the 
program is provided only to those customers who order 
the PRPQ. 

prompt. A displayed request for information or operator 
action. 

I protocol. A set of rules governing the communication and 
1 transfer of data between two or more devices in a 
I communications system. 

PRPQ. See Programming Request for Price Quotation 

(PRPQ). 

record. A collection of fields that is treated as a unit. 

relative file. Same as direct file. 

remote. Pertaining to a device, file, or system that is 
accessed by your system through a communications line. 
Contrast with local. 

remote job entry (RJE). Sending job instructions and 
possibly data to a remote system requesting it to run a job. 

request unit. In SNA, the record transmitted to the other 
system. This record can contain a request, data, or both. 

resource security. A System Support Program Product 
option that restricts the use of information in files, 
libraries, folders, and folder members to specified users. 

response unit. In SNA, the record sent to respond to a 
request. The response can be either positive or negative 
and can include control information. 

RJE. See remote job entry (RJE). 

run. To cause a program, utility, or other machine 
function to be performed. 

SDLC. See synchronous data link control (SDLC). 

I security. The protection of data, system operations, and 
I devices from accidental or intentional ruin, damage, or 
I exposure. See also system security. 

sequential file. A file in which records occur in the order 
in which they were entered. Contrast with direct file and 
indexed file. 
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session. (1) The logical connection by which a System/36 
program or device can communicate with a program or 
device at a remote location, (2) The length of time that 
starts when an operator signs on the system and ends 
when the operator signs off the system. 

severity code. A code that indicates how serious a 
compiling error or an operating error is. 

sign off. To end a session at a display station. 

sign on. (Verb) To begin a session at a display station. 

single line communications adapter/attachment (SLCA). In 

data communications, a feature that allows a single 
communications line to be connected to System/36. 

SLCA. See single line communications adapter/attachment 
(SLCA). 

SNA. See systems network architecture (SNA). 

SNA Upline Facility (SNUF). The SSP-ICF subsystem 
that allows System/36 to communicate with CICS/VS 
and IMS/VS application programs. Also, using this 
subsystem, DHCF communicates with HCF and DSNX 
communicates with DSX. 

SNBU. See switched network backup (SNBU). 

SNUF. See SNA Upline Facility (SNUF). 

source member. A library member that contains 
information in the form in which it was entered, such as 
RPG specifications. Contrast with load member. 

source program. A set of instructions that are written in a 
programming language and that must be translated to 
machine language before the program can be run. 

special character. A character other than an alphabetic or 
numeric character. For example; *, +, and % are special 
characters. 

spool file. A disk file that contains output that has been 
saved for later printing. 

spooling. The part of the System Support Program 
Product that saves output on disk for later printing. 

SSP. See System Support Program Product (SSP). 

SSP-ICF. See Interactive Communications Feature 
(SSP-ICF). 

station. A computer or device that can send or receive 
data. 

status. A condition. For example, the status of a printer, 
a job, or a communications line. 


subconsole. A display station that controls a printer or 
printers. 

subconsole display. A display that can be requested only 
from a command display that appears on a subconsole. 
From a subconsole display an operator can display and 
send messages, and enter all control commands except 
those that can be entered only at the system console. See 
also console display. 

subroutine member. A library member that contains 
information that must be combined with one or more 
members before being run by the system. 

subsystem. The part of communications that handles the 
requirements of the remote system, isolating most 
system-dependent considerations from the application 
program. 

switched line. In data communications, a connection 
between computers or devices that is established by 
dialing. Contrast with nonswitched line. 

switched network backup (SNBU). In data 
communications, a technique that provides a switched line 
connection when a nonswitched line fails. 

synchronous. Occurring in a regular or predictable 
sequence. 

synchronous data link control (SDLC). A form of 
communications line control that uses commands to 
control the transfer of data over a communications line. 
Compare with binary synchronous communications (BSC). 

system. The computer and its associated devices and 
programs. 

system configuration. A process that specifies the 
machines, devices, and programs that form a particular 
data processing system. 

I system console. A display station from which an operator 
I can keep track of and control system operation. 

system bbrary. The library, provided with the system, that 
contains the System Support Program Product and is 
named #LIBRARY. 

system printer. The printer that is used for any printed 
output that is not specifically directed to another printer. 

system services control point (SSCP). A focal point within 
an SNA network for managing the configuration, 
coordinating network operator and problem determination 
requests, and providing directory support and other 
session services for network users. 
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system unit. The part of the system that contains the 
processing unit, the control panel, the disk drive and the 
disk, and either a diskette drive or a diskette magazine 
drive. 

systems network architecture (SNA). A set of rules for 
controlling the transfer of information in a data 
communications network. 

table. A collection of data in which each item is uniquely 
identified by a label, by its position relative to the other 
items, or by some other means. 

terminal. In data communications, a device, usually 
equipped with a keyboard and a display device, capable of 
sending and receiving information over a communications 
line. 

translation table. A table that provides replacement 
characters for characters that cannot be printed by the 
3262 printer. 

transmission control characters. In data communications, 
special characters that are included in a message to control 
communication over a data link. For example, the sending 
station and the receiving station use transmission control 
characters to exchange information; the receiving station 
uses transmission control characters to indicate errors in 
data it receives. 

transparent data. Data that can contain any hexadecimal 

value. 

transparent text mode. A mode that allows BSC to send 
and receive messages containing any of the 256 character 
combinations in hexadecimal, including transmission 
control characters. 

truncate. To shorten a field or statement to a specified 
length. 

turnaround. Changing a communications line from 
transmit mode to receive mode or from receive mode to 
transmit mode. 

turnaround time. The time interval required to reverse the 
direction of transmission over a communication line. 

unbind command. An SNA command used to reset the 
protocols for a session. Contrast with bind command. 

unique. The only one. 

unprocessed record. A record that is not transformed by 
MSRJE before it is stored. 

utibty control statement. A statement that gives a utility 
program information about the way the program is to 
perform or the output it is to produce. 


I utility program. (1) A program provided to perform a 
I task that is required by many of the programs using the 
I system; for example, a program that copies information 
I from diskette to disk. (2) A System Support Program 
I Product program that performs a common task. 

valid. (1) Allowed. (2) True, in conforming to an 
appropriate standard or authority. 

variable. A name used to represent a data item whose 
value can change while the program is running. Contrast 
with constant. 

vertical tab table. A table used by MSRJE that contains 
values indicating the line on a page to skip to before 
printing. 

voice-grade telephone line. A telephone line that is 
normally used for transmission of voice communications. 
The line requires a modem for data communications. 

I volume table of contents (VTOC). An area on a disk or 
I diskette that describes the location, size, and other 
I characteristics of each file, library, and folder on the disk 
I or diskette. 

VTOC. See volume table of contents (VTOC). 

work station. A device that lets people transmit 
information to or receive information from a computer; 
for example, a display station or printer. 

World Trade. (1) Pertains to the distinction between the 
US and the rest of the world. (2) Pertains to the 
combination of : 

• IBM World Trade Americas/Far East Corporation 

• IBM World Trade Europe/Middle East/Africa 
Corporation 


X.21. In data communications, a specification of the 
CCITT that defines the connection of data terminal 
equipment to an X.21 (public data) network. 

X.21 feature. The feature that allows System/36 to be 
connected to an X.21 network. 

I X.21 short hold mode. An option specified during system 
I configuration that allows a circuit switched line to be 
I disconnected when the line is not active. 

X.25. In data communications, a specification of the 
CCITT that defines the interface to an X.25 (packet 
switching) network. 

X.75. A standard that defines ways of interconnecting 
two X.25 networks. 
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3270 Device Emulation. A feature of the System Support 
Program Product that allows a System/36 local or remote 
device to appear as a 3270 device to another system. 


1 3278 Device Emulation. A feature of the System Support 
1 Program Product that allows a System/36 local or remote 
1 device to appear as a 3278 device to another system. 


Glossary 


G-ll 
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Index 


Special Characters 


&MAXSESS, SNA 8-6 
&MLBFSIZ, BSC 7-8 
&NUMBUF, BSC 7-8 
&NUMBUF, SNA 8-6 
&NUMCMBS, BSC 7-8 
&NUMJOES, BSC 7-9 
&NUMJOES, SNA 8-7 
&NUMLNES, BSC 7-9 
&NUMLNES, SNA 8-7 
&NUMRJE, BSC 7-9 
&NUMRJE, SNA 8-7 
&NUMTPBF, SNA 8-7 
&PRTRANS, BSC 7-9 
&PRTRANS, SNA 8-8 
&SPOLMSG, BSC 7-10 
&SPOLMSG, SNA 8-8 
&TPBFSIZ, BSC 7-10 
&TPBFSIZ, SNA 8-8 
&TPIDCT, SNA 8-8 
&WAITIME, SNA 8-8 
^WAITIMT, BSC 7-10 
$SEPPDIR macroinstruction 8-16 
#LIBRARY, definition G-1 



abnormal termination, definition G-1 
access methods 
BSC 

JES2 7^6 
JES3 7-7 
REAM 7-6 
VM370 RSCS 7-7 
definition G-1 
SNA JES3 8-4 
access mode, definition G-1 
acquire, definition G-1 
activating 

a configuration 3-1 
a location 3-1 
a remote location 
BSC 2-13 
SNA 2-31 

an MSRJE reader 3-12 
MSRJE 3-1 


adapter, definition G-1 
add to existing file 

print output to a data file 5-25, 5-30 
print output to compressed file 5-4$ 
print output to compressed file with carriage 
information 5-50,5-52 
punch output to a data file 5-56 
punch output to compressed file for disk file 5-64 
adding output 

print output to an existing compressed file 5-34 
punch output to compressed file for disk file 5-62 
adding print output to an existing compressed file 5-43 
addressing, definition G-1 

advanced program-to-program communications (APPC), 
definition G-1 

aligning forms, printer output 5-17, 5-35 
allocate, definition G-1 
alphabetic character, definition G-1 
alphameric, definition G-1 
alphanumeric, definition G-1 
alternative index, definition G-1 
alternative system console, definition G-1 
American National Standard Code for Information 
Interchange (ASCII), definition G-1 
American National Standards Institute (ANSI), 
definition G-1 
ANSI 

See American National Standards Institute 

APPC 

See advanced program-to-program communications 

application 10 

MSRJE Logon Attributes display 2-39 
REAM macro, RES SNA 8-30 
VSE POWER, SNA 8-40 
application name 
JES2 SNA 8-5 
JES3 SNA 8-22 

application program, definition G-1 
APPLID 

JES2 8-5 
JES3 8-22 
parameter 

host system name 2-32 
value 2-36 

REAM macro, RES SNA 8-30 
assigning a terminal to a line, JES3 BSC 7-23 
associated line member, subsystem member 
BSC 2-11 
SNA 2-29 

associating subsystem member with a line member 
BSC 2-11 
SNA 2-29 
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ATTR OCL statement 2-15,2-33 
attiibnte, definition G-1 
attributes of BSC subsystem member 2-14 
authority level 

CONSOLE parameter, JES3 SNA 8^24 
console, JES3 BSC 7-21 
autoanswer, definition G-1 
autocall unit, definition G-1 
autocall, definition G-1 
automatic logoff, RES BSC 7-28 
automatic logon, JES3 SNA 8-26 
automatic mode 

printer, JES2 BSC 7-14 
punch, JES2 BSC 7-16 
automatic start of printer, JES2 SNA 8-13 
automatic start of punch, JES2 SNA 8-17 


B 


batch BSC, definition G-1 
batch processing, definition G-1 
batch, definition G-1 

binary synchronous communications IBSC), definition G-2 
binary, definition G-2 
bind command 

definition G-2 
entries B-1 

received by System/36 B-1 
bit, definition G-2 
block check character, definition G-2 
block location, specifying 5-9 
block size, print output to compressed file 5-46 
blocks 

definition G-2 

freeing, print output to compressed file with carriage 
information 5-53 

reserving, print output to compressed file with 
carriage information 5-53 
bps, definition G-2 
BSC 

See also binary synchronous communications 
activating a remote location 2-13 
associating subsystem member with a line 
member 2-11 
attributes, reader 2-22 
changing a subsystem member 2-8 
communications access methods 
JBS2 7-6 
RTAM 7-6 
VM370RSCS 7-7 
communications controller 7-6 
configuring the subsystem 2-7 
creating a new location 2-12 
creating a subsystem member 2-8 


BSC (continued) 

creating a subsystem member from existing 2^8 

creating from existing 2-12 

defining subsystem member attributes 2-14 

deleting a subsystem member 2-8 

describing MSRJE characteristics 2-7 

editing an existing location 2-12 

existing member library name 2-9 

existing member name 2-9 

forms control table defaults 2rl9 

forms control table name 2-19 

fornis set table 2-19 

host subsystem work sheets A-2 

host system name 2-14 

host systems supported by MSRJE 1-6 

JES2 

communications access 7-6 
host subsystem work sheets A-2 
initialization parameters 7-8 
number of host readers 2-23 
number of printers 2-20 
number of punches 2*20 
SIGNON format 2-16 
transparency 2-23 
JES2 SIGNON 

passwordl 2-16 
password2 2-17 
RMTnnn parameter 2-16 
JESS 

communications access 7-7 
host subsystem work sheets A-4 
initialization parameters 7-20 
number of host readers 2-23 
number of printers 2-20 
SIGNON format 2-17 
transparency 2-23 
JESS SIGNON 
format 2-17 
namex 2-17 
passwordl 2-17 
password2 2-17 
Job priority 2-15 
library for subsystem member 2-8 
LOGON SIGNON 2-16 
maximum number of printers 2-20 
MSRJE characteristics 2-7 
naming remote location 2-13 
number 

of host readers 2-23 
of MSRJE readers 2-22 
printer 

attributes 2-19 
file sequence number 2-20 
punch 

attributes 2-19 

file sequence number 2-21 
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BSC (continued) 

reader attributes 2-22 
remote location 
activating 2-13 
naming 2-13 

remote system selecting 2-12 
removing a remote location 2-12 
RES 

example C-1 
generation example 7-31 
host subsystem work sheets A-6 
line member configuration example C-1, C-5 
number of host readers 2-23 
number of printers 2-20 
transparency 2-23 
RES LOGON 
format 2-17 
MAIL 2-18 
NOTICES 2-17 
password 2-17 
PROC(procname) 2-17 
TBRM(termid) 2-17 
userid 2-17 

RES LOGON format 2-17 
reviewing 

a remote location 2-12 
a subsystem member 2-8 
RSCS, host system generation 7-36 
RTAM 

communications access 7-6 
macroinstructions 7-27 
parameters 7-28 
stage 1 7-27 

stage 2 7-30 
selecting 

remote system 2-12 
subsystem type 2-11 
SIGNON LOGON 2-16 
specifying 

member type 2-10 
protocol 2-10 

stage 1 of RTAM generation 7-27 
stage 2 of RTAM generation 7-30 
subsystem definition example 2-7 
subsystem member 
attributes 2-14 
configuration 2-7 
name 2-8 
selection 2-11 
termination delay 2-15 
text transparency 2-23 
viewing a subsystem member 2-8 
VM370RSCS 

communications access 7-7 
host subsystem work sheets A-8 
number of host readers 2-23 
number of printers 2-20 
transparency 2-23 


BSC (continued) 

VM370 RSCS SIGNON 
format 2-18 
password 2-18 
RBMOTEnn 2-18 
3705 PEP generation example 7-35 
BSC conversion to SNA 8-3^ 

BSC Subsystem Member Selection display 2-11 
BSCEL (binary synchronous communications equivalence 
link) subsystem, definition G-2 
buffer sixe 
RES 

BSC 7-29 
SNA 8-29 

RJPTERM, BSC JES3 7-24 
VM370 RSCS BSC 7-39 
buffer sixe, SNA JES2 8-9 
buffer, definition G-2 
BUFSIZE parameter, JES2 SNA 8-9 
BUFXSIZ parameter, RES SNA 8-29 
byte, definition G-2 


c 


C4fcSM 

See Communications and Systems Management 
cailt definition G-2 
CANCEL utility control statement 
format 4-9 
introduction 4-9 
parameters 
LRDn 4-9 
PRn 4-9 
RDn 4-9 
result of 4-9 
cancel, definition G-2 
canceling 

a utility function 4-9 
the control table utility 5-8 
card control character insertion JES2 SNA 8-17 
card reader definition, JES2 BSC 7-18 
carriage control character insertion, JES2 SNA 8-13 
caniage control characters 5-20, 5-38 
CCITT 

See Consultative Committee on International 
Telegraphy and Telephone 
CCTL parameter 

print, JES2 SNA 8-13 
punch, JES2 SNA 8-17 
chaining 

a subsystem member 
BSC 2-8 
SNA 2-26 

defaults, forms control table 
print destination D-7 
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changing (continued) 

defaults, forms control table (continued) 
punch destination D~10 
forms control table defaults 
print destination D-7 
punch destination D-10 
SETFORM utility control statement 4~ 11 
the forms name 4-11 
changing defaults^ forms control tahle 
print destination D“7 
punch destination D~10 
changing forms control table defaults 
print destination D-7 
punch destination D-10 
channel control character 
definition G-2 
explanation 5*20 
channel definition G-2 
character compression, JES3 BSC 7-26 
character key, definition G-2 
character, definition G-2 
characteristics 

host system 2-3 
of BSC MSRJE 2*7 
characters per inch 
definition G*2 
printer output 5*19, 5-37 
checkpoint 

cards, SNA JES2 8-17 
pages, SNA JES2 8-14 
printer for JES2 BSC 7-14 
child, definition G-2 
CICS subsystem, definition G-2 
CICS/VS, definition G-2 
CKPTLNS parameter 

print JES2 SNA 8-14 
punch JES2 SNA 8-17 
CKPTPGS parameter 

print JES2 SNA 8-14 
punch JES2 SNA 8-17 
clocking, definition G-2 
close, definition G-2 
CMD 

BSC default 2-24 
SNA default 2-45 

CNFIGICF procedure command 2-2, 3-1 
CNFIGSSP procedure 2-1 
CNMSGNO parameter, SNA RES S-28 
code, definition G-2 
collating sequence, definition G-2 
column separator, definition G-2 
COM0EFN statement 8-22 
command display station, definition G-2 
command display, definition G-2 


command file, definition G-3 
command keys 

CNFIGICF BSC 2-7 
CNFIGICF SNA 2-25 
definition G-3 
from MSRJE console 3-11 
READFILE in progress display 3-16 
subsystem member configuration 2-10, 2-28 
COMMAND parameter, MSRJE procedure 
command 3-5 

command processor, definition G-3 
commands 
bind B-1 
definition G-2 
ENABLE C-10 
host system 1-3 
comment, definition G-3 
common carrier, deBnition G-3 
communications access methods 
BSC 

JES2 7-6 
JES3 7-7 
REAM 7-6 
VM370 RSCS 7-7 
SNA 

JES2 8-4 
JES3 8-4 
REAM 8-4 

communications adapter, definition G-3 
Communications and Systems Management (C & SM), 
definition G-3 

communications control program (CCP), definition G-3 
communications controOer 
BSC 7-6 
SNA 8-3 

communications line definition for JES2 BSC 7-11 
communications lines 
defimtion G-3 
total used by MSRJE 1 -7 
communications link 
definition G-3 
example of establishing E-1 
communications secmity, definition G-3 
communications subsystem, definition G-3 
communications, definition G-3 
compaction 

printer, JES2 SNA 8-18 
punch, JESS SNA 8-26 
REAM macro, RES SNA 8-30 
SNAJBS2 8-14 
compressed disk file 

defining print entries for control table 5-3, 5-5 
defining punch entries for control table 5-7 
compression 

character, JES3 BSC 7-26 
definition G-3 




V.. ^ 
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compression {continued) 

printer, JBS2 SNA cS~t5 
punt:h, JS2 SN! A H- IH 
RTAfVl macro, RIES SNA 8 30 
compression and expansloo, JES2 8-10 
compyter iiipiil: devices 1“ I 
configwration 

activating 3-1 
definition G-3 
parts ol a 3 -1 

coiifigyration member, definition G”3 
conBgmre, defioiOcai 
CONPR parameter, SNA RES 8-29 
console 

authority Icvcf 11 A3 HS(' 7 21 
definition (j~3 
EIES3 BSC 7Gi) 
output, RES BSC 7~2R 

supf)ort 

iES2 BSC 7A2 
JES3 BSC 7-24 
RES BSC 

console aiithorit3/ IcveE JES3 ESC 7-21 
console display, clefiiiition G-3 
conso'Ie Input 

ENTER key 3-10 
input area 3-10 
logged to history file 3-9 
MSRIE aiility control slaieinerits 4-1 
record length 3~i0 
utility conUol statements 
CANCEL 3-iO 
END 3-10 
LIBRARY 3-10 
READFl'LE 3-K) 

SETFORM 3-iO 
using 3-10 

conscfle message buffers, RES SNA 8'-28 
console ontpiiL RES ESC 7-29 
CONSOLE parameter 

MSRJE procedure command 3-7 
SNA JES3 authority level 8-24 
SNA JEtS3 destcodc K-23 
SNA jES3 line length 8-24 
SNA JES3 message buffer size 8-24 
SNA JES3 message classes 8-23 
SNA iES3 message destination 8-23 
SN A J ES3 iiam c 8-22 
SNA JES3 TYRE 8-22 
console printer for SNA SES 8-29 
console support 
JES2 

BSC 7-12 
SNA 8-10 
JES3 

BSC 7-24 
SNA 8-22 


console support (continued) 

RES 

BSC 7-28 
SNA 8-28 

SNA VSE POWER 8-41 
constant, definition G~3 
control field, definition G-3 

control output, print output to compressed file printer 
definilion 5-35 
control storage, definition G-3 
control table entry 
print data 

compressed disk file 5-3, 5-5 
defining compressed disk file 5-3, 5-5 
defining indexed file 5-4 
defining print entries 5-2 
defining spooled entries 5-3 
defining unprocessed records 5-3 
defining user-defined file 5-4 
indexed file 5 -4 
output to printer 5-2 
spooled output 5-3 
unprocessed records 5-3, 5-5 
user-defined file 5-4 
punch data 

compressed disk file output 5-7 
defining compressed disk file 5-7 
defining indexed file 5-7 
defining user-defined file 5-6, 5-7 
disk file output 5-6 
indexed file 5-7 
user-defined file 5-6, 5-7 
control table entry name, specifying 5-11 
control table entry type, selecting 5-11 
control table file, reading 5-1 
Control Table menu of the control table utility 5-8 
control table output, directing 5-12 
control table utility 
canceling 5-8 
Control Table menu 

existing table name 5-8 
new table name 5-8 
preferred disk location 5-9 
selecting the operation 5-8 
table name 5-8 
defining the table name 5-8 
end of forms message 5-17, 5-36 
entry menu 5-10 
host forms name 5-1 
naming entries 5-1 

number of copies of spooled output 5-21 
print default 5-1, 5-54 
print output to a compressed file 
file size 5-46 
library for procedure 5-45 
print output to a data file 

add to existing file 5-25, 5-30 
delete capable file 5-27, 5-32 
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control table iitiity {continued) 

print output to a data file (continued) 
extending the file 5-26, 5-31 
file extendability 5-26, 5-31 
file location 5-26, 5-31 
file name 5-24, 5-29 
file size 5-26,5-31 
file type 5-24, 5-29 
freeing unused space 5-25, 5-30 
indexed file 5-27 
library for procedure 5-24, 5-29 
preferred file location 5-26, 5-31 
procedure library 5-24, 5-29 
procedure name 5-24, 5-29 
record leiigth 5-27, 5-32 
resource security 5-24, 5-29 
save on error 5-25, 5-30 
user ID 5-24, 5-29 
print output to a disk file 5-24, 5-28 
print output to compressed disk file 5-32 
print output to compressed file 
add to existing file 5-45 
delete capable file 5-47 
error save 5-33, 5-43 
existing file 5-34, 5-43 
extending the file 5-46 
file extendability 5-33, 5-42, 5-46 
file location 5-33, 5-42, 5-46 
file name 5-33, 5-42, 5-44 
file name example 5-44 
file size 5-33, 5-42 
file type 5-45 

freeing unused space 5-34, 5-43, 5-45 
number of blocks 5-33, 5-42 
preferred file location 5-46 
preferred location 5-33, 5-42 
procedure library 5-45 
procedure name 5-45 
record length 5-47 
resource security 5-33, 5-42, 5-44 
save on error 5-45 
saving the file 5-33, 5-43 
user ID 5-33,5-42,5-44 
print output to compressed file for a disk file 5-41, 
5-60 

print output to compressed file for disk file with 
carriage information 5-48 
print output to compressed file with carriage 
infomation 

file name example 5-51 
print output to compressed file with carriage 
information 

add to existing file 5-50 
adding to existing files 5-52 
delete capable files 5-54 
error save 5-50 
extending the file 5-49, 5-53 


control table utility (continued) 

print output to compressed file with carriage 
information (continued) 
file extendability 5-49 
file location 5-49 
file name 5-49 
file size 5-49 
file type 5-52 
freeing disk space 5-50 
freeing unused blocks 5-53 
library name 5-52 
preferred disk location 5-53 
preferred location 5-49 
procedure name 5-52 
record length in bytes 5-54 
reserving blocks 5-53 
resource security 5-49, 5-52 
saving files 5-52 
saving the file 5-50 
user ID 5-49, 5-52 

print output to disk file, extending a file 5-33, 5-42 

print quality 5-17,5-36 

print style 5-17, 5-18, 5-36 

printer data streams 5-2 

printer output 

align forms 5-17, 5-35 
carriage control characters 5-20, 5-38 
continue printing 5-39 
defining the characters per inch 5-19, 5-37 
defining the lines per Inch 5-19, 5-37 
formatting of 5-18 
hold in spool file 5-39 
last line on a page 5~20, 5-38 
lines per page 5-1 9, 5-37 
local forms name 5-17, 5-35 
number of copies 5-39, 5-40 
printing and end of job step 5-39 
specifying line skips 5-20, 5-38 
spool file activity 5-40 
spooled display 5-20 
spooling 5-17,5-35 
punch default 5 -1, 5 67 
punch output 
defining 5-6 
punch output to a data file 
add to existing file 5-56 
delete capable file 5-58 
extending the file 5-57 
file extendability 5-57 
file location 5-57 
file name 5-55 
file size 5-57 
file type 5-56 
freeing unused space 5-56 
indexed file 5-59 
library for procedure 5-56 
preferred file location 5-57 
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control table utility (continued) 

pimch output to a data file (continued) 
procedure library 5-56 
procedure name 5-55 
record length 5-58 
resource security 5-55 
save on error 5-56 
user ID 5-55 

punch output to a disk file 5-55 
punch output to compressed file for disk file^ 5-60 
add to existing file 5-64 
adding output 5-62 
allowing duplicate keys 5-67 
delete capable file 5-66 
error save 5-62 
extending the file 5-61 
file extendabOity 5 -61 
file location 5-61 
file name 5-61 
file name example 5-61,5-63 
file size 5-61 
file type 5-64 
free unused blocks 5-64 
freeing disk space 5-62 
length of key 5-67 
library name 5-64 
number of blocks to be reserved 5-65 
number of blocks to extend the file 5-65 
preferred disk location 5-65 
preferred location 5-61 
procedure name 5-64 
record length in bytes 5-66 
resource security 5-61, 5-64 
save in case of error 5-64 
saving the file 5-62 
starting position of key 5-67 
user ID 5-61,5-64 

punch output to compressed file with carriage 
information, file name example 5-49 
running 5-8 
spool file activity 5-22 
spool file priority 5-22 
spooled output 5-21 
starling 5-8 
use of 1-8 
controllifig 

MSRiC 4-1 
print outpui 5-2 
conyerting 

print data 6-1 

print data to printed output 1-8 
punch data 6-1 
punch data to data files 1-8 
converting from System/34 to System/36 1-10 


copies, number to be priiitecl 5-39, 5-40 
copying lines of data 

console input 3 if 
reader input 3-15 
correcting problems F-1 
CPI 

See characters per incis 

create 

a SNA subsystem merrbei Ifom cxisihg; 2 2v-' 
new BSC subsystem meinbci fiom exislhig 2-8 
new SNA subsystem member 2-26 

creating 

a BSC subsystem member 2-8 
the forms oontiol I able C -27 

current library 

definition G-3 

LIBRARY utility control siaUancnl 4-7 

cursor, definition G“"3 


D 


D parameter, MSMJE procedure eoiwiiiariicl d-S 
data block size, SNA VSE POWER 
data communications, definition C-3 
data display station, definition G'»”3 
data file, definition G-3 
data Item, deflellion G-3 
data link escape (OLE), definsition Q-4 
data link, definition G‘-4 
data management, deflnllion CJ-4 
data mode, cleflnllioe €■ 4 
DATA parameter 
JES2 2-36 

MSRJE procedure corrimaud 3-5 
data set, defiiiiiion CL 4 
data streams 

control table utility 5 -2 
definition G-4 
types of 1-3 

data terMinal equipment (D'l'l’), definition 
date-differentiated files 
definition G -4 
using 5“i 
DCE 

See data circuit-teniiinatirig ecfUifmieiU 
deactivate, definition G>4 
decimal, defimtion CG4 

default 

definition G-4 
for CMD SNA 2-45 
for DEL SNA 2-45 
for TYPE SNA 2-44 
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default message class for a reader, SNA JES2 8-20 
default value 
CMD 2-24 
definition G-4 
DEL 2-24 
TYPE 2-24 
defaults 

forms control table changing D-7 
forms control table print 5 -1, D-1 
forms control table punch 5-1, D-5 

defining 

a control table 5-1 
a print default entry 5-54 
a punch default entry 5-67 
an RJE terminal for JES3 BSC 7-24 
remote locations 2-4 
remote work stations for JES2 BSC 7-11 
subsystem members 2-4 
the remote location 2-31 
the SNA subsystem member 2-25 
definition, device for JES3 BSC 7-22 
DEL 

BSC default 2-24 
SNA default 2-45 

BEL parameter, MSRJE procedure command 3-6 
delay time for termination 
BSC 2-15 
SNA 2-32 
delete-capable file 
BSC 2-24 
definition G-4 

print output to a data file 5-27, 5-32 

print output to compressed file 5-47 

punch output to a data file 5-58 

punch output to compressed file for disk file 5-66 

SNA 2-45 

delete subsystem member 
BSC 2-8 
SNA 2-26 
delete, definition G-4 

deleting files, print output to compressed file with carriage 
Information 5-54 
delimiter, definition G-4 
destination 

print output 3-18 
punch output 3-20 
device definition 

JES3 BSC 7-22 
JES3 SNA 8-24 

DEVICE statement, SNA JES3 8-24 
devices, input 1-1 
diagnosing problems F-1 
dial feature for JES3 BSC 7-22 
direct file, definition G-4 


DISABLE, active MSRJE 3-25 
disable, definition G-4 
flisabling an MSRJE remote location 3-25 
DISCINTV, SNA JES3 8-10 
disconnect interval 
JES2 BSC 7-12 
JES2SNA 8-10 

disk 

definition G-4 
file utility 
input 6-1 

OCL statements 6-2 
preferred location 

compressed disk output for disk file, punch 5-61 
compressed disk output with carriage information, 
print 5-49 

compressed disk output, print 5-33, 5-42 
Control Table menu 5-9 
print output to a disk file 5-26, 5-31 
print output to compressed file 5-46 
punch output to a disk file 5-57 
disk file creation date, MSRJE procedure command 3-4 
disk file utility 
input 6-1 
introduction to 1-8 
OCL statements 6-2 
requirements 6-1 
starting 6-1 
disk file, definition G-4 
disk input ot MSRJE reader 3-15 
disk location 

print output to compressed file with carriage 
information 5-53 

punch output to compressed file for disk file 5-65 
DISK parameter, MSRJE procedure command 3-5 
display screen, definition G-4 
display station, definition G-4 
display, definition G-4 
displays 

BSC Subsystem Member Selection 2-11 
create an MSRJE forms control table compressed disk 
file entry 5-32, 5-41, 5-48, 5-63 
create an MSRJE forms control table print entry 
additional characteristics 5-26, 5-31 
data file characteristics 5-44, 5-46 
file characteristics 5-51, 5-53 
for an indexed file 5-27 
for disk file with carriage information 5-28 
indexed file 5-47 
print format 5-37 
print information 5-35 
printer IDs 5-36 
spool information 5-39 

create an MSRJE forms control table punch entry 
compressed disk file for disk file 5-60 
disk file output 5-55 
file characteristics 5-57 
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displays (continued) 

create an MSFIJB forms control table punch entry 
(continued) 

indexed file 5-59, 5-66 
creating an MSRJE forms control table print 
entry 5-16, 5-17, 5-19, 5-21 
creating an MSRJE forms control table print entry for 
disk file output 5-24 
MSRJE Control Table Utility 

create a control table entry 5-10, 5-11 
Create an MSRJE forms control table print 
entry 5-14 

Work with control tables 5-8, 5-9 
MSRJE Logon Attributes 2-16, 2-34, 2-39 
MSRJE Printer 

Punch Attributes 2-40 
MSRJE Printer/Punch Attributes 2-19 
MSRJE Reader Attributes 2-22, 2-43 
MSRJE Subsystem Member Attributes 2-14, 2-32 
Remote Location Definition 2-13, 2-31 
Remote Location Selection 2-12, 2-30 
SNA Configuration Member Type 2-28 
SNA Subsystem Member Selection 2-29 
SSP-ICF Configuration Member Definition 2-7, 

2-9, 2-25, 2-27 

SSP-ICF Configuration Member Type 2-10, 2-28 
Distributed Systems Executive (BSX), definition G~4 
Distributed Systems Node Executive (DSNX), 
definition G-™4 
DSNX 

See Distributed Systems Node Executive 

DSX 

See Distributed Systems Executive 
DTE 

See data terminal equipment 
Dup key 

from MSRJE console 3-11 
from Reader Input display 3-15 
duplicate keys« punch output to compressed file for disk 
file 5-67 


E 


EBCDIC 

See extended binary-coded decimal interchange code 
EBCDIC character, definition G-4 
editing SNA subsystem member 2-26 
EIA 

See Electronic Industries Association 
eight-line communications adapter/attachment (ELCA), 
definition G-4 
ELCA 

See eight-line communications adapter/attachment 


emulation, definition G-4 
ENABLE procedure command 

example C-10 
format 3-1 
parameters 

library name 3-2 
line number 3-2 
location 3-2 
NOSHOW 3-2 
SHOW 3-2 

subsystem member name 3-1 

enable, definition G-4 
enabling a configuration 3-1 

end of forms message, control table utility 5-17, 5-36 
END utility control statement 

explanation 4-13 
format 4-13 
ending 

an MSRJE session 3-23 
reader 4-8 
reader input 4-8 

ending SNA subsystem member definition 2-45 
enter, definition G-5 
entering jobs from a remote location 1-2 
entry menu 

control table utility 5-10 
heading 5-10 
EOF utility control statement 
explanation 4-8 
format 4-8 
result of 4-8 

terminating an MSRJE reader 3-13 
error save 

print output to compressed file 5-33, 5-43 
print output to compressed file with carriage 
information 5-50 

punch output to compressed file fer disk file 5-62 
establishing a communications link, example E-1 
examples 

BSC RES C-1 

BSC RES line member configuration 
BSC RES subsystem member configuration C-5 
BSC, 3705 PEP generation 7-35 
ENABLE procedure command C-10 
establishing a communications link E-1 
forms control table creation C-27 
forms control table default entry D-1 
generation, BSC RES generation 7-31 
MSRJE 1-4 

MSRJE configurations 2-5, 2-6 
SNARES C-13 

SNA RES line member configuration C-13 
SNA RES subsystem member configuration C-19 
exchange station ID, definition G-5 
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existing BSC member library name 2«9 
existing member name 
BSC 2-9 
SNA 2-27 

existing SNA library name 2"-27 
extendable disk file, definition G-5 
extended binary-coded decimal Interchange code 
(EBCDIC), definition G-5 
extending a file 

print output to a data file 5-26, 5-31 
print output to compressed file 5-33, 5-42 
print output to compressed file with carriage 
information 5-53 
punch output to a data file 5-57 
punch output to compressed file for disk file 5-61, 
5-65 

extending the file 

print output compressed file 5-46 
print output to compressed file with carriage 
information 5-49 


Lll 

feature, definition G-5 

field, definition G-5 

file class for VM370 MSCS BSC 7-36 

fie extendabilty 

print output to a data file 5-26, 5-31 
print output to compressed file 5-33, 5-42, 5-46 
print output to compressed file with carriage , 
information 5-49 ' ' 

punch output to a data file 5-57 
punch output to compressed file for disk file 5-61 
fie location 

print output to a data file 5-26, 5-31 
print output to compressed file 5-46 
print output to compressed file with carriage 
information 5-49 

print output to compresses disk 5-33, 5-42 
punch output to a data file 5-57 
punch output to compressed file for disk file 5-61 
fie name 

definition G-5 

print output to a data file 5-24, 5-29 
print output to compressed file 5-33, 5-42, 5-44 
print output to compressed file with carriage 
information 5-49 
punch output to a data file 5-55 
punch output to compressed file for disk file 5-61 
file name example 

punch output to compressed file for disk file 5-61 
punch output to compressed file with carriage 
information 5-49 


file save on error 5-25, 5-30, 5-45, 5-56 
file saving 

control table utility 

punch output to compressed file for disk 
file 5-64 

print output to compressed file with carriage 
information 5-52 
file size 

print output to a data file 5-26, 5-31 
print output to compressed file 5-33, 5-42, 5-46 
print output to compressed file with carriage 
information 5-49 
punch output to a data file 5-57 
punch output to compressed file for disk file 5-61 
file type 

control table utility 

punch output to compressed file for disk 
file 5-64 

print output to a data file 5-24, 5-29 
print output to compressed file 5-45 
print output to compressed file with carriage 
information 5-52 
punch output to a data file 5-56 
file, definition G-5 
filling out host system work sheets 2-2 
first LOGON 2-34 
folder member, definition G-5 
folder, defliiition G-5 
format 

definition G-5 

ENABLE procedure command 3-1 
formatted SNA LOGON 2-34 
formatting printer output 5-18 
forms control table 

assigning names 5-1 
BSC 

print default 2-19 
punch default 2-19 
creating 5-1 
creation example C-27 
default entry 

changing D-7 
example D-1 
print D~1 
punch D-5 

entry names 3-18, 3-21 

host forms names 3-18, 3-21 

host printer balancing 5-15 

matching host forms name to table entries 5-1 

name of 5-8 

naming entries 5-1 

print entries 5-2 

print output 3-18 

printer ID 5-15, 5-16, 5-35 

punch output 3-20 

taking advantage of 3-20, 3-22 
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forms controS table name 
BSC 2-! 9 
SNA 2^40 

forms control table utility 
print default 5-1 
punch default 5~1 
forms identifier 

JES2BSC 7-15 
prim, jES2 SNA 8-15 
punch, JES2 
SNA 8-18 
forms identifier, punch 
JES2BSC 7-17 
f orros mount messages 5 -1 
forms name, changing 4-11 
FORMS parameter 

JES2 SNA print 8-15 
jES2 SNA punch 8-18 
forms set 

BSC 2-19 
SNA 2-40 

FORMS, JESI BSC punch 7-17 
freeing disk space 

print output to compressed file with carriage 
information 5-50 

punch output to compressed file for disk file 5-62 
freeing unused blocks 
control table utility 

punch output to compressed file for disk 
file 5-64 

print output to compressed file with carriage 
information 5-53 
freeing unused space 

print output to a data file 5-25, 5-30 
print output to compressed file 5-34, 5-43, 5-45 
punch output to a data file 5-56 
function key, definition G“-5 


L£J 

generation 

BSC R-2 7-27 


language 


BSC 

7-33 

SNA 

8-32 

RES example 

BSC 

7-31 

SNA 

8-31 

RSCS host system 

RTAM 

SNA 

7-27, 8-28 

JES2 

8-5 

JES3 

8-22 

RES 

8-27 

VSE POWER 


generation (continued) 

SNA (continued) 

VSl system requirements 8-27 
3705-11 example 8-34 
3705 PEP 

example 7-35 
NCP 7-33 

generation requirements, RES SNA 8-27 
group name, JES3 SNA work station 8-26 


H 


handling output data streams 5-1 
handset, definition G-5 
hard copy, definition G-5 
hardware, definition G-5 
Help key, definition G-5 
help text, definition G-5 
hex, definition G-5 
hexadecimal, definition G-5 
history file 

console input logged to 3-9 
definition G-5 
operator messages 3-22 
holding input from a JES2 SNA reader 8-20 
holding reader jobs, JES2 BSC 7-18 
horizontal tab table, definition G-5 
host data sets for SNA 2-42 
host forms name 3-18, 3-21, 5-1 
host name 

MVS 2-14 
OS/VSl 2-14 
VM370RSCS 2-14 

host printer balancing, forms control table 5-15 
host procedure name for RES LOGON, SNA SDLC 
host readers, maximum for SNA 2-44 
host subsystem work sheets 
BSC 

JES2 A-2 
JES3 A-4 
RES A-6 
VM370 RSCS A-8 
SNA 

JES2 A-11 
JES3 A-13 
NCPVTAM A-10 
RES A-15 
VSE POWER A-17 
host system 

BSC RSCS generation 7-36 
characteristics 2-3 
commands 1-3 
configuration for MSRJE 1-9 
definition G-5 


2-37 


Index 
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host system (continued) 

ending the MSRJE connection 3-24 
generation 

SNAJES2 8-5 
SNA JES3 8-22 
SNARES 8-27 
SNA VSE POWER B-40 
logon attributes 2-15 
MSRJE 1-6 

number of BSC readers 2-23 
signon attributes 2-15 
SNA name 2-32 
SNA, defining MSRJE to 8-1 
supported by MSRJE 1-6 
host system name for BSC 2-14 
host system work sheets 

during subsystem configuration 2-7 
filling out 2-2 

number of SNA punches 2-41 
uses during configuration 2-25 


0 

I/O 

S'ee input/output 

IBM 37xx communications controller 7-6, S-3 
ID, definition G-5 
Index, definition 0-5 
Indexed file 

allowing duplicate keys 5-27, 5-47,5-59 
defining entries for control table 5*4,5-7 
print entry 5-27 
punch entry 5-59 
size of key 5-27, 5-47, 5-59 
INFOMSO utility control statement explanation 4-12 
informational mess^es 
definition G-5 
SNA 2-33 

initial program load (IPL), definition 0-5 
initiall 2 ;ation jmrameters 
JES2 

BSC 7-8 
SNA 8-5 
JES3 SNA 8-22 
initialize, definition G-5 
input 

devices, computer 1-1 
reader, MSRJE utility control statements 4-1 
to MSRJE 3-9 
traditional computer 1-1 
input devices, computer I-l 


input stream, definition G-5 
mput to MSRJE 1 -4 
input/output (1/O), definition G-5 
input, definition G-5 
ln<|uiiy mode, definition G-5 
im|uiry, definition G-5 
installing MSRJE 2-1 

Interactive Communications Feature (SSP-ICF), 
definition G-6 

interactive processing, definition G-6 
interactive, definition G-5 
interface type 

RES BSC 7-28 
RES SNA 8-28 
interface, JES2 BSC 7-12 
Internal forms set table 
BSC 2-19 
SNA 2-40 

inteiTupt, definition G-6 
IPL 

See initial program load 


0 

JCL used in submitting jobs 1 -3 

JES2 

BSC 

&TPBFSIZ 7-10 
&TPIDCT 7*10 
&WAITIME 7-10 
automatic mode, printer 7-14 
automatic mode, punch 7-16 
buffer size 7-8 
buffers, number of 7-8 
card reader definition 7-18 
communications access 7-6 
communications line definition 7-11 
communications lines, number of 7-9 
console message buffers, number of 7-8 
console support 7-12 
disconnect interval 7-12 
forms identifier printer 7-15 
forms identifier punch 7-17 
holding reader jobs 7-18 
host subsystem work sheets A-2 
initialization parameters 7-8 
interface 7-12 

job output elements, number of 7-9 

LINE macro 7-11 

line transparency 7-11 

message class 7-19 

number of buffers 7-8 

number of communications lines 7-9 

number of console message buffers 7-8 

number of host readers 2-23 
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JES2 (continued) 

BSC (continued) 

number of job output elements 7-9 
number of printers 2-20, 7-12 
number of punches 2-20, 7-12 
number of readers 7-13 
number of remote terminals 7-9 
output destination for a reader 7-19 
password, line 7-11 
print translation 7-9 
printer checkpoint 7-14 
printer definition 7-13 
printer output class 7-15 
printer output limit 7-15 
printer page size 7-14 
printer routing code 7-16 
printer separator pages 7-15 
printers, number of 7-12 
punch checkpoint 7-17 
punch definition 7-16 
punch output class 7-17 
punch output for a reader 7-19 
punch output limit 7-17 
punch routing code 7-17 
punches, number of 7-12 
reader job class 7-18 
reader priority limit 7-19 
readers, number of 7-13 
record length 7-12 
Remote Job Entry 7-6 
remote terminals, number of 7-9 
remote work station definition 7-11 
ROUTECODE 7-13 
routing code 7-13 
selection priority for a reader 7-19 
separator page line count 
separator cards 7-17 
setup information 7-13 
spool message count 7-10 
starting a printer 7-15 
starting a punch 7-17 
starting a reader 7-18 
terminal password 7-13 
terminal transparency 7-13 
transmission code 7-11 
transparency 2-23 
BSC SIGNON 2-16 
number of BSC printers 2-20 
number of BSC punches 2-20 
SNA 

&NUMBUF 8-6 
&NUMJOES 8-7 
&NUMLNES 8-7 
&NIJMRJE 8-7 
&NUMTPBF 8-7 
&PRTRANS 8-8 
&SPOLMSG 8-8 
&TPBFSIZ 8-8 


JES2 (continued) 

SNA (continued) 

&TPIDCT 8-8 
(ScWAITIME 8-8 
application name 8-5 
APPLID 8-5 

automatic start of printer 8-13 

automatic start of punch 8-17 

buffer size 8-9 

BUFSIZE parameter 8-9 

card control character insertion 8-17 

carriage control character insertion 8-13 

CCTL parameter 8-13 

CCTL parameter, punch 8-17 

checkpoint cards 8-17 

checkpoint pages 8-14 

CKPTLNS parameter 8-14 

CKPTLNS parameter, punch 8-17 

CKPTPGS 8-14 

CKPTPGS parameter, punch 8-17 

communications access 8-4 

compaction 8-14 

compaction, printer 8-18 

compression and expansion 8-10 

compression, printer 8-15 

compression, punch 8-18 

console support 8-10 

default message class for a reader 8-20 

DISCINTV 8-10 

disconnect interval 8-10 

forms identifier 8-15 

forms identifier, punch 8-18 

FORMS parameter 8-15 

FORMS parameter, punch 8-18 

holding input from a reader 8-20 

host subsystem work sheets A-11 

line definition 8-9 

line password 8-9 

LINEnnn 8-9 

logical unit name 8-10 

LOGON parameter 8-5 

LUNAME parameter 8-10 

maximum number of VTAM sessions 8-6 

MAXSESS 8-6 

KOCCTL parameter 8-13 

NOCCTL parameter, punch 8 -17 

number of buffers 8-6 

number of cards 8-17 

number of console messages 8-6 

number of host readers 2-44 

number of job output elements 8-7 

number of lines 8-7 

number of printer 8-10 

number of printers 2-41 

number of punches 2-41,8-11 

number of readers 8-11 

number of RJE terminals 8-7 

number of teleprocessing buffers 8-7 
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JES2 (contimed) 

SNA (continued) 

NUMFR parameter S~10 

NUMFU parameter 8-11 

HUMRD parameter 8-11 

output class, print S-! 4 

output class, punch 8-18 

page size 8-14 

PASSWORD parameter 8-11 

PASSWORD, line 8-9 

password, terminal 8-11 

PASSWORD, VTAM 8-5 

print line translation 8-8 

printer destination for a reader B-21 

printer line width 8-16 

printer logical record length 8-15 

printer output 8-16 

priority level limit 8-21 

punch destination for a reader 8-21 

punch logical record length 8-19 

punch output routing code 8-19 

reader job class 8-20 

reader priority selection 8-21 

record length 8-10 

Remote Job Entry 8-4 

remote printer definition 8-13 

remote printer separator pages 8-8 

remote punch definition 8-17 

remote reader definition 8-20 

remote terminal function interval 8-8 

remote work station definition 8-9 

RMTnn parameter 8-9 

RMTnnn.PRm parameter 8-13 

RMTnnn.RDm parameter 8-20 

Rnnn.PUm parameter 8-17 

separator cards, punch 8-19 

separator pages, printer 8-16 

setup header 8-12 

setup information 8-12 

SETUPHDR parameter 8-12 

SETUPINF parameter 8-12 

spool message count 8-8 

starting a printer 8-15 

startin g a punch 8-18 

starting a reader 8-20 

system generation 8-5 

system wide initialization parameters 8-5 

teleprocessing buffer size 8-8 

TERMINAL parameter 8-9 

terminal type 8-9 

unit type 8-9 

VTAM password 8-5 

wait interval 8-12 

WAITIME parameter 8-12 


JES2 LOGON 

password 1 parameter 2-36 
password2 parameter 2-36 
RMTnnn parameter 2-36 

JESS 

BSC 

assigning a terminal to a line 7-23 
buffersize, RJPTERM 7-24 
character compression 7-26 
communications access 7-7 
console authority level 7-21 
console line length 7-21 
console support 7-24 
device definition 7-22 
dial feature 7-22 
host subsystem work sheets A~4 
line adapter 7-22 
line definition 7-22 
line group 7-22 
line password 7-23 
line speed 7-23 
linename 7-22 

message destination codes 7-20 
messages, number of 7-21 
number of host readers 2-23 
number of messages 7-21 
number of printers 2-20, 7-25 
number of punches 2-20, 7-25 
number of readers 7-25 
operator’s console 7-20 
print width 7-25 
printers, number of 7-25 
punch record size 7-25 
punches, number of 7-25 
readers, number of 7-25 
RJPLINE 7-22 
RJPTERM 7-24 
RTAM 7-7 
starting a line 7-23 
terminal name 7-20 
terminal password 7-26 
terminal type 7-20 
terminal type, RJPTERM 7-24 
transparency 2-23 
transparency line 7-22 
transparency terminal 7-24 
work station name, RJPTERM 7-24 
BSC SIGNON 2-17 
number of BSC printers 2-20 
number of BSC punches 2-20 
number of SNA punches 2-41 
SNA 

application name 8-22 
APPLID 8-22 

authority level, CONSOLE parameter 8-24 
automatic logon 8-26 
COMDEFN statement 8-22 
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JES3 (continued) 

SNA (continued) 

communications access 8-4 

compaction 8-26 

CONSOLE name 8-22 

CONSOLE parameter, authority level 8-24 

CONSOLE parameter, destcode 8-23 

CONSOLE parameter, line length 8-24 

CONSOLE parameter, message classes 8-23 

CONSOLE parameter, TYPE 8-22 

console support 8-22 

device definition 8-24 

DEVICE statement 8-24 

group name, work station 8-26 

host subsystem work sheets A-13 

initialization parameters 8-22 

line length, CONSOLE parameter 8-24 

logical unit name 8-26 

logon attempt limit 8-26 

LU parameter 8-26 

LU statement 8-22 

message buffer size 8-24 

message classes 8-23 

N parameterm RJPWS statement 8-25 

number of host readers 2-44 

number of LU sessions 8-22 

number of printer 8-25 

number of printers 2-41 

number of punches 2-41, 8-25 

number of readers 8-25 

P parameter, RJPWS statement 8-26 

password, terminal 8-26 

PR parameter 8-25 

PU parameter 8-25 

RD parameter 8-25 

remote work station definition 8-25 

RJP name, CONSOLE 8-22 

RJPWS statement 8-25 

RTAM 8-4 

SYSOUT statement 8-27 
system generation 8-22 
VTAM password 8-22 
work station console support 8-26 
work station group name 8-26 
work station name 8-25 
JES3 LOGON 

password parameter 2-37 
wsname parameter 2-37 
job 

definition G-6 
JCL 1-3 
job class 

reader, JES2 SNA 7-18, 8-20 
job control language (JCL) 1-3 


job file, definition G-6 
job priority 

BSC 2-15 
SNAMSRJE 2-33 
valid entries 
BSC 2-15 
SNA 2-33 

job queue, definition G-6 

job separators, VSE POWER SNA 8-40 

job step, definition G -6 


K 


K-byte, definition G-6 

key length, control table utility, punch output to compresseil 

file for disk file 5-67 

key starting position, control table utility, punch oiilput to 
compressed file for disk file 5-67 
key, definition G-6 
keyword, definition 4-2, G-6 


L 


label, definition G-6 
LDESCR, RES BSC 7-27 
leased line, RES BSC 7-28 
length of key, indexed file 5-47 
library 

for subsystem member 
BSC 2-8 
SNA 2-26 
specifying 4-6 
library for procedure 

print output to a data file 5-24, 5-29 
print output to compressed file 5-45 
punch output to a data file 5-56 
library member, definition G-6 
library name 

ENABLE procedure command 3-2 
MSRJE procedure command 3-4 
print output to compressed file with carriage 
information 5-52 

library name, control table utility, punch output to 
compressed file for disk file 5-64 
LIBRARY utility control statement 
current library 4-7 
explanation 4-6 
parameter names 4-6 
library, definition G-6 
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line adapter, JES3 BSC 7-22 
line definition 

JES2 SNA 8-9 
JESS BSC 7-22 

line description, RTAM RES BSC 7-27 
Une group, JESS BSC 7-22 
line identifier, BSC RES RTAM 7-27 
line length console, BSC JESS 7-21 
line length, CONSOLE parameter for JESS SNA S-24 
LINE macro 
JES2 BSC 

explanation 7~11 
subparameters, EBCDIC 7-11 
subparameters, HISPEED 7-11 
subparameters, line speed 7-11 
subparameters, list of 7-11 
subparameters, LOWSPEED 7-11 
subparameters, NOTRANSP 7-11 
subparameters, PASSWORD 7-11 
subparameters, security password 7-11 
subparameters, transmission code 7-11 
subparameters, TRANSP 7-11 
subparameters, transparency 7-11 
line macro, RTAM RES BSC 7-27 
line members 

associated with SNA subsystem member 2-29 
associating with BSC subsystem member 2-11 

line name, JESS BSC 7-22 
line number 

ENABLE procedure command 3-2 
RES BSC 7-28 
line password, JES2 SNA 8-9 
line skips for printer output 5-20, 5-38 
line speed 

JESS BSC 7-23 
RTAM RES BSC 7-28 
LINEID, RES BSC 7-27 
LINEnnn, JES2 SNA 8-9 
lines per inch, printer output 5-19, 5-37 
lines per page 

print entry 5-38 
printer ouput 5-19, 5-37 
link identifier, VM370 RSCS BSC 7-36 
load member, definition G-6 
load module, definition G-6 
load, definition G-6 
local forms name 5-17,5-35 
local system characteristics, defining SNA 2-25 
local, definition G-6 
location name, definition G-6 
logical page size, printer JES2 BSC 7-14 
logical unit (LU), definition G-6 
logical unit name 

JES2SNA 8-10 
JESS SNA 8-26 
VSE POWER SNA 8-41 


LOGMODE parameter 2-36 
logoff, automatic RES BSC 7-28 
LOGON 
RES 

BSC 2-17 
SNA 2-37 
SNA 

application ID 2-39 
APPLID parameter 2-36 
DATA parameter 2-36, 2-39 
display 2-34 
first 2-34 
format 2-36 
formatted 2-34 
LOGMODE parameter 2-36 
mode name 2-39 
VSE POWER 2-38 
SNA VSE POWER 2-38 
logon attempt limit, JES3 SNA 8-26 
logon attributes, BSC 2-16 
LOGON attributes, SNA 2-39 
LOGON parameter, JES2 SNA 8-5 
LOGON SIGNON text for BSC 2-16 
LU 

See logical unit 

LU parameter, JES3 SNA 8-26 
LU statement, JES3 SNA 8-22 
LUNAME parameter, JES2 SNA 8-10 


M 


macroinstructlon, $SEPPDIR 8-16 
MAIL, BSC RES LOGON 2-18 
main storage processor, definition G-6 
main storage, definition G-6 
manu, definition G-6 
manual answer, definition G-6 
manual call, definition G-6 
matching host forms name to table entries 5-1 
maximum number of RES SNA sessions 8-29 
member name, subsystem 
BSC 2-8 
SNA 2-26 

message buffer size, JES3 SNA 8-24 
message buffers, RES BSC 7-29 
message class 

JES2BSC 7-19 
JES3SNA 8-23 

message destination codes, JES3 ESC 7-20 
message destination, CONSOLE parameter for JES3 
SNA 8-23 
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message handling during unattended operation 3-26 
message identification code (MIC), definition G-6 
message identification, definition G”6 
MIC 

See message identification code 
MLCA 

See multiline communications adapter/attachment 
mode name 2-39 
modem, definition G-6 
modulate, definition G-6 
modulation, definition G-7 
modulator-demodulator (modem), definition G-7 
MSRJE 

See also Multiple Session Remote Job Entry 

activating 3~1 

bind command B~1 

communications line 2-2 

configuration 2-2 

configuration examples 2-5, 2-6 

console input 3-9 

Console Input display 3-9 

console priority 2-15 

controlling 4-1 

creating a print entry for printer output 5-14 
describing characteristics of 2-7 
disabling the connection with the host system 3-24 
disk file utility 

explanation 6-1 
introduction to 1-8 
enabling 3-1 
ending a session 3-23 

ending the connection with the host system 3-24 
examples 

BSC RES C-1 

BSC RES line member configuration 

BSC RES subsystem member configuration C-5 

SNARES OS/VSl 

SNA RES line member configuration C-13 
SNA RES subsystem member 
configuration C-19 
first LOGON 2-34 
host systems 1-6 
installing 2-1 
line members 2-2 

Logon Attributes display 2-16, 2-34, 2-39 

number of BSC i ;aders 2-22 

output 3-17 

overview 1-1 

phases 4-1 

problem determination F-1 
procedure command 

COMMAND parameter 3-5 

CONSOLE parameter 3-7 

D parameter 3-5 

DATA parameter 3-5 

DEL parameter 3-6 

disk file creation date parameter 3-4 

DISK parameter 3-5 


MSRJE (continued) 

procedure command (continued) 
format 3-3 

library-name parameter 3-4 
location parameter 3-4 
NODEL parameter 3-6 
NOREL parameter 3-6 
P parameter 3-5 
PROC parameter 3-5 
read-file-name parameter 3-4 
RELEASE parameter 3-6 
S parameter 3-5 
SOURCE parameter 3-5 
reader input 3-12 
disk 3-15 
display station 3-14 
reader display 3-14 
valid entries from a display station 3-14 
Reader Input display 3-8 
reader termination 3-13, 3-17 
relationship to SNA Host systems 8-2 
remote location, disabling 3-25 
remote system definition 2-3 
signing on to 3-3 
SNA 

configuration 2-24 
console priority 2-33 
defining to host system 8-1 
LOGON attributes 2-34, 2-39 
number of readers 2-43 
X.25 link protocol 8-1 
SNA priority level 2-33 
starting 3-1 
starting a session 3-3 
startup display for MSRJE console 3-7 
status of 3-27 
subsystem member 2-4 
system requirements 1-7 
system resource security and 1-10 
unattended operation 
description 3-26 
message handling 3-26 
termination 3-26 
user ID, reading file 5-1 
MSRJE console, command keys 3-11 
MSRJE control table utility 1-8 
MSRJE Control Table Utility display 5-S, 5-9, 5-10, 
5-11,5-14 

MSRJE disk file utility, introduction to 1-8 
MSRJE example 1-4 

MSRJE Printer/Punch Attributes display 2-19, 2-40 
MSRJE procedure command, explanation 3-3 
MSRJE procedure, ending 3-7 
MSRJE Reader Attributes display 2-22, 2-43 
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MSEJE Subsystem Member Attributes display 2-“14, 2-32 
MSRJE user ID, reading file 5-1 
MSRJE utiiities 

MSRJE iitllity eontrol statements 1 -4 
MULTILEAVING buffer size for JES2 BSC 7-8 
MULTILEAVING buffers, RES BSC 7-30 
MULTILEAVING Remote Job Entry (MRJE) on 
System/34 1-10 

multlliiie communications adapter/attachment (MLCA), 
definition G-7 

Multiple Session Remote Job Entry (MSRJE), 
definition G'^7 
multiple, definition G-7 
multipoint, definition G«-7 
MVS, host name 2-14 


N 


N parameter, RJPWS statement for JES3 SNA 8-25 
name of control table entry, specifying 5-11 
namex parameter for BSC JES3 SIGNON 2-17 
naming a remote location 
BSC 2-^13 
SNA 2-31 

NCP (Network Control program) 8-3 

NCT^ VTAM, SNA host subsystem work sheets A-10 

NCP with Partitioned Emulation Programming (PEP) 8-3 

need for remote job entry 1-1 

negative response, definition G-T 

nest, definition G-T 

nesting* READFILE statements 4-5 

network, deflnlllon G"7 

NOCCTL parameter 

print, JES2 SNA 8-13 
punch JES2 SNA 8-17 
node name, MES SNA 8-29 
NODE parameter, RES SNA 8-29 
NODEL parameter, MSRJE procedure command 3-6 
NOHALT capability 3-22 

rson-retwra-to-zero inverted (NRZI), definition G~7 

nonswifdied line, definition G-7 

NOR EL parameter, MSIRJE procedure command 3-6 

NOSHOW parameter, ENABLE procedure command 3-2 

NOTICES for BSC RES LOGON 2-17 

NMZf 

See noii-retum-to -zero inverted 
nui character string, definition G-7 
null character, defliiitlon G-7 
rioniber of 

JES2 SNA buffers 8-6 
iES2 SNA cards 8-17 
jES2 SNA console messages 8-6 
JES2 SNA jof) output elements 8-7 
JES2 SNA lines 8-7 


number of (continued) 

IES2 SNA printers 2-20, 8-10 
JES2 SNA punches 8»11 
JES2 SNA readers 8H1, 8-25 
JES2 SNA RJE terminals 8-7 
JES2 SNA teleprocessing buffers 8-7 
JESS SNA LU sessions 8-22 
JESS SNA printers 8-25 
JESS SNA punches 8-25 
LU sessions VSE POWER SNA 8-40 
RES SNA buffers 8-29 
RES SNA punches 8-28 
RES SNA readers 8-28 
VTAM JES2 SNA sessions 8-6 
number of blocks, print output to compressed fMe 5-33, 
5-42 

number of buffers 
JES2 BSC 7-8 
RES BSC 7-29 

number of communications lines, JES2 BSC 7-9 
number of console message buffers 
JES2 BSC 7-8 
number of host readers 
BSC 

JES2 2-23 
JES3 2-23 
RES 2-23 
VM370 RSCS 2-23 
JES2 SNA 2-44 
JES3 SNA 2-44 
RES SNA 2-44 
VSE POWER SNA 2-44 
number of job output elements, JES2 BSC 7-9 
number of messages, JES3 BSC 7-21 
number of printers 
BSC 

explanation 2-20 
JES3 2-20 
RES 2-20 
VM370 RSCS 2-20 
JES2BSC 7-12 
JES3 BSC 7-25 
RES BSC 7-29 
SNA 

explanation 2-40 
JES2 2-41 
JES3 2-41 
RES 2-41 
VSE POWER 2-41 

number of printers, total for RES SNA 8-30 
number of punches 
BSC 

explanation 2-20 
JES2 2-20 
JES3 2-20 
RES 2-20 
VM370 RSCS 2-20 


/if 
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number of punches (continued) 

JES2 BSC 2-20, 7-12 
JES3 

BSC 2-20,7-25 
SNA 2-41 
RES 

BSC 2^20,7-29 
SNA 2-41 
SNA 

JES2 2-41 
maximum 2-41 
SNA VSE POWER 2-41 
number of punches, lota! for RES SNA 
number of punches, VM370 RSCS BSC 2-2CI 
number of leaders 
BSC 

host 2-23 
MSRJE 2-22 
JES2BSC 7-13 
JES3 BSC 7-25 
RES BSC 7-28 
SNA MSRJE 2-43 
numbei of readers, total for RES SNA 
number of remote terminals, JES2 BSC 7-'^ 
number of RES SNA printers 
number of sessions, SNA mimiiiitm 2-^33 
number of SNA sessions 2»33 
numeric, definition G-7 
NUMPR parameter 
JES2 BSC 7-12 

NUMPR parameter for JES2 SNA S-»1CI 
NUMPU parameter 
JES2 BSC 7-12 

NUMPU parameter for JES2 SNA 11 
NUMRD parameter 
JES2BSC 7-13 
JES2SNA 8-11 



object program, defiiiitioo G-7 
OCi. 

See operation control language 
OCl. statements, running disk file irtiMty wbh 6-A, 
offline, definitioi! G--? 
online, definStioii G-7 
open, definition G-7 
operand, definition G'“7 

operation control language (OCL), definlBon G-7 
operator messages 

host system 3-22 
MSRJE 3-22 


operators console, JES3 BSC 7“*20 
OS/ OSI host name 2-14 
OS/VS Host 8-39 
output 

compressed disk file for a disk file 5-13 
compressed disk file for a disk file with carriage 
infotmation 5-13 

compressed disk file for a printer 5-13 
definition G-7 
directing printer 5-12 
disk file 5-12 

disk file with carriage information 5-12 
from control table utility 5-12 
from MSRJE 1-4, 3-17 
outi.mt class 

'jeS2SNA 8-14 
printei, JES2 BSC 7N5 
pimch, JF7S2 BSC 7-17 
punch. JES2 SNA 8-18 
output destination for a reader, JES2 BSC 7-19 
output limit, punch, JES2 BSC 7-17 
output stream, definition G-7 
O'-'^'orview 

of MSRJE 1-1 
of remote job entry 1-3 
EJE 1-3^ 


E 

P parameter 

MSRJE procedure command 3-5 
RJPWS statement for JESS SNA 8-26 


pad, definition 

G-7 

page ske, JES7 SNA 

pea amelers 


definition 

JES2 

G 7 

BSC 

7-8 

SNA 

8-5 

JES2 SIGNON 


password2 2-17 
RMTnne 2-16 

IES2 SIGNON password! 2-16 
JBS3BSC 7^20 
JESS SIGNON 
namex 2* 17 
password 1 2-17 

password2 2-17 
JESS SNA 8-22 
RES LOGON 

password 2-17 
userid 2-17 

RJFILE procedure conwiand 6-2 
RTAM 

BSC 7-28 
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parameters (continued) 

RTAM (continued) 

SNA 8^28 
SNA 

APPLID 2-36 
DATA 2-36 
LOGMODE 2-36 
MAIL 2-37 
NOTICES 2-37 
password 2-37 
password 1 2-36 

password2 2-36 
PROC(procname) 2-37 
remid 2-38 
RMTnnn 2-36 
TERM(termid) 2-37 
userid 2-37 
wsname 2-37 
VM370 RSCS SIGNON 
password 2-18 
REMOTEnn 2-18 
parent, definition G-7 

Partitioned Emulation Programming (PEP), NCP 8-3 
password 

definition G-7 
JES2 SNA terminal 8-11 
level, JES2 BSC 7-11 
line, JESS BSC 7-23 
SNA VSE POWER 8-40 
password parameter 

BSC RES LOGON 2-17 
BSC VMS70 RSCS SIGNON 2-18 
PASSWORD parameter, JES2 SNA 8-11 
password security, definition G-7 
PASSWORD, for SNA JES2 VTAM 8-5 
PASSWORD, JES2 SNA line 8-9 
password, RTAM macro for RES SNA 8-30 
password, terminal 
JES2 

BSC 7-13 
JESS 

BSC 7-26 
SNA 8-26 

password, VM370 RSCS BSC 7-39 
password 1 parameter 

BSC JES2 SIGNON 2-16 
BSC JESS SIGNON 2-17 
password2 parameter 

BSC JES2 SIGNON 2-17 
BSC JES3 SIGNON 2-17 
PCHS parameter, RES SNA 8-28 
PDIR 

See peripheral data set information record 

PDIR processing 8-25 


pended DISABLE 3-25 
PEP 8-3 

peripheral data set Inforniatloii records 
See also PDIR 
definition G-7 
use of 5-1 

permanent RES SNA logon 8-29 

phone list, definition G-7 

physical record, definition G--8 

PLGN parameter, RES SNA 8-29 

poifit-to-point line, definition G-8 

poll, definition G-8 

polling, definition G-8 

port, definitiori G-8 

position, definition G-8 

positiona! parameter, definition G-8 

POWER macro, SNA VSE POWER 8-4!l 

PR parameter, JES3 SNA 8-25 

preferred disk location 

compressed disk output 
prim 5-33,5-42 
compressed disk output for disk file 
punch 5-61 

compressed disk output with carriage Information 
print 5 “49 

Control Table menu 5-9 
print output to a disk file 5-26, 5-31 
print output to compressed file 5-46 
punch output to a disk file 5-57 
preferred file location 

print output to a data file 5-26, 5-31 
print output to compressed file 5-46 
punch output to a data file 5-57 
preferred location 

print output to compressed file 5-33, 5-42 
print output to compressed file with carriage 
information 5-49 

punch output to compressed file for disk file 5-61 
primary Index, definition G-8 
print data 

converting 6-1 

defining entries for control table 5-2 
print data streams, control table utility 5-2 
print data to compressed disk file 5-2 
print default entry 

control table file 5-54 
forms control table D-1 
when used 5-2 

print default, forms control table 5-1 
print entry for printer output 5-14 
print file sequence number 3-19, 5-44 
print image, definition G-8 
print line translation, JES2 SNA 8-8 
print output 

compressed disk file 3-19 
label 3-19 

print file sequence number 3-19 
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print output (continued) 
controlling 5-2 
default destination 3-18 
destination 3-18 
unprocessed records 3-19 
label 3-19 

print file sequnce number 3-19 
print output to a compressed file for disk file 5-60 
print output to a compressed file for disk file with carriage 
information 5-48 
print output to a data file 

add to existing file 5-25, 5-30 
delete capable file 5-27, 5-32 
extending the file 5-26, 5-31 
file extendability 5-26,5-31 
file location 5-26,5-31 
file name 5-24, 5-29 
file size 5-26,5-31 
file type 5-24, 5-29 
freeing unused space 5-25, 5-30 
indexed file 5-27 
library for procedure 5-24, 5-29 
preferred file location 5-26, 5-31 
procedure library 5-24, 5-29 
procedure name 5-24, 5-29 
record length 5-27, 5-32 
resource security 5-24, 5-29 
save on error 5-25, 5-30 
user ID 5-24, 5-29 
print output to a disk file 5-24 
indexed file 5-27 

print output to compressed disk file for printer 
output 5-32 

print output to compressed fOe 
add to existing file 5-45 
adding to existing file 5-34 
adding to exsting file 5-43 
block size 5-46 
delete capable file 5-47 
error save 5-33, 5-43 
extending a file 5-33, 5-42 
extending the file 5-46 
file extendability 5-33, 5-42, 5-46 
file location 5-33, 5-42, 5-46 
file name 5-33, 5-42, 5-44 
file size 5-33, 5-42, 5-46 
file type 5-45 

freeing unused space 5-34, 5-43, 5-45 
indexed file 

allowing duplicate keys 5-47 
length of key 5-47 
size of key 5-47 
start of key 5-47 
library for procedure 5-45 
number of blocks 5-33, 5-42 
preferred file location 5-46 
preferred location 5-33,5-42 


print output to compressed file (continued) 
printer definition 5-35 
procedure library 5-45 
procedure name 5-45 
record length 5-47 
resource security 5-33, 5-42 
save on error 5-45 
saving the file 5-33, 5-43 
user ID 5-33,5-42 

print output to compressed file for a disk file 5-41 
print output to compressed file with carriage information 

add to existing file 5-50 
adding to existing files 5-52 
delete capable files 5-54 
error save 5-50 
extending files 5-53 
extending the file 5-49 
file extendability 5-49 
file location 5-49 
file name 5-49 
file size 5-49 
file type 5-52 
freeing disk space 5-50 
freeing unused blocks 5-53 
library name 5-52 
preferred disk location 5-53 
preferred location 5-49 
procedure name 5-52 
record length in bytes 5-54 
reserving blocks 5-53 
resource security 5-49 
saving files 5-52 
saving the file 5-50 
user ID 5-49 

print quality, control table utility 5-17, 5-36 
print style 

control table utility 5-36 

print style, control table utility 5-17, 5-18, 5-36 
print translation, JES2 BSC 7-9 
print wheel, definition G-8 
print width 

JES3 BSC 7-25 
RES BSC 7-28 
printer attributes 
BSC 2-19 
SNA 2-40 

printer automatic mode, JES2 BSC 7-14 
printer checkpoint, JES2 BSC 7-14 
printer data streams 1-3 
printer definition 

JES2BSC 7-13 

print output to compressed file 5-35 

printer destination for a JES2 SNA reader 8-21 
printer file sequence number 
BSC 2-20 
SNA 2-41 
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printer ID 

forms control table 5-16 

printer ID, forms control table 5-15, S-35 
printer line length, JES2 SNA S-16 
printer logical page size, JES2 BSC 7-14 
printer logieal record length, JES2 SNA ^-15 
printer output 

align forms 5-17, 5-35 
carriage control characters 5-20, 5-38 
characters per inch 5*19, 5-37 
formatting output 5*18 
line skips 5-20, 5-38 
lines per inch 5-19, 5-37 
lines per page 5-19, 5-20, 5-37, 5-38 
local forms name 5-17, 5-35 
spooled display 5-20 
spooling 5*17,5-35 
printer output class, JES2 BSC 7*15 
printer output limit, JES2 BSC 7-15 
printer output routing code, JES2 SNA 8-16 
printer routing code, JES2 BSC 7-16 
printer separator pages, JES2 BSC 7-15 
printer starting, JES2 BSC 7-15 
printer, maximum for BSC 2-20 
printing at end of job step 5-39 
printing, controlling of 5-39 
printout, definition G-8 
priority level limit, JES2 SNA 8-21 
priority levels 2-15 

priority limit for a JES2 BSC reader 7-19 
problem determination 
definition G-8 
procedure to follow F-1 
problems, solving F-1 

PROC parameter, MSRJE procedure command 3-5 
PROC(procname), BSC RES LOGON 2-17 
procedure commands 
CNFIGICF 3-1 
definition G-8 
ENABLE 3-1 
RJFILE 6-2 
procedure library 

print output to a data file 5*24, 5-29 
print output to compressed file 5-45 
punch output to a data file 5-56 
procedure member, definition G-8 
procedure name 

print output to a data file 5*24, 5-29 
print output to compressed file 5-45 
print output to compressed file with carriage 
information 5*52 
punch output to a data file 5*55 
punch output to compressed file for disk file 5*64 
procedures 

CNFIGICF 2*2 
CNFIGSSP 2*1 


procedures (continued) 
definition G*8 
RJFILE 5-1,5*2 
RJTABLE 5*1,5-S 
processing PDIRs 8-25 
processing unit, definition G-8 
program products, definition 2-1, G-8 
pri^am, definition G-8 

Programming Request for Price Quotation (PRPQ), 
definition G-8 
prompt, definition G-8 
protocol, definition G-8 
PRPQ 

See Programming Request for Price Quotation 
PSWRD parameter, VSE POWER SNA 8-41 
PTRS parameter, RES SNA 8-28 
PU parameter, JES3 SNA 3-25 
punch attributes 
BSC 2*19 
SNA 2*40 

punch checkpoint, JES2 BSC 7-17 
punch data 

converting 6-1 
destination of 3-20 
punch data streams 1-3 
punch default entry, control table utility $-67 
punch default entry, forms control table D-5 
punch default, forms control table 5-1 
punch definftion, JES2 BSC 7-16 
punch destmatlon for a JES2 SNA reader 8-21 
punch fie sequence niiinher 
BSC 2-21 

control table utility 5*61, 5-63 
disk file 3-21 
punch output 3-21 
SNA 2*41 

punch logical ps^e size, JES2 BSC 7-16 
punch logical record length, JES2 SNA 8-19 
punch output 

compressed disk file, punch file sequence 
number 3-21 
default destination 3-21 
defining 5*6 

to compressed disk file 5-7 
to indexed file 5*7 
to user-defined file 5*7 
unprocessed records, punch file sequnce 
number 3*21 

punch output for a reader, JES2 BSC 7-19 
punch output limit, JES2 BSC 7-17 
punch output routing code, JES2 SNA 8-19 
punch output to a compressed fie for disk file 5-60 
punch output to a compressed fie for disk fie with carii^e 
information 5-48 
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punch output to a data file 
add to existing file 5-56 
delete capable file 5-58 
extending the file 5-57 
file extendability 5-57 
file location 5-57 
file name 5-55 
file size 5-57 
file type 5-56 
freeing unused space 5-56 
indexed file 5-59 
library for procedure 5-56 
preferred file location 5-57 
procedure library 5-56 
procedure name 5-55 
record length 5-58 
resource security 5-55 
save on error 5-56 
user ID 5-55 

punch output to a disk file 5-55 

indexed file start of key 5-59 
indexed file, start of key 5-47 
punch output to compressed file for disk file 
adding output 5-62 
error save 5-62 
extending the file 5-61 
file extendability 5-61 
file location 5-61 
file name 5-61 
file name example 5-61 
file size 5-61 
freeing disk space 5-62 
preferred location 5-61 
resource security 5-61 
saving the file 5-62 
user ID 5-61 

punch output to compressed file with carriage information, 
file name example 5-49 
punch record size, JES3 BSC 7-25 
punch routing code, JES2 BSC 7-17 
punch starting, JES2 BSC 7-17 


R 


RD parameter, JES3 SNA 8-25 
RDRS parameter, RES SNA $-2$ 
read-file-name, MSRJE procedure coinmand 3-4 
reader attributes 
BSC 2-22 
SNA 2-43 

reader input, MSRJE utility control statements 4-1 
reader priority selection, JES2 SNA 8-21 


reader route code, JES2 BSC 7-19 
READFILE in progress display 
ATTN key 3-16 
command keys 3-16 
explanation 3-16 
READFILE utility control statement 
as console input 3-10 
explanation 4-3 
format 4-3 
nesting of 4-5 
parameters 
date 4-3 
library 4-3 
name 4-3 
type 4-3 
record length 
JES2 

BSC 7-12 
SNA 8-10 

print output to a data file 5-27, 5-32 
print output to compressed file 5-47 
print output to compressed file with carriage 
information 5-54 
punch output to a data file 5-58 
punch output to compressed file for disk file 5-66 
record size, disk input 3-17 
records 

definition G-8 
unprocessed 6-1 
relative file, definition G-8 

RELEASE parameter, MSRJE procedure command 3-6 
remote job entry 

definition 1-1, G-8 
need for 1-1 
remote location 

activating BSC 2-13 
activating SNA 2-31 
definition 2-4 
entering jobs from a 1-2 
naming 

BSC 2-13 
SNA 2-31 
SNA definition 2-31 

Remote Location Definition display 2-13, 2-31 
remote location name 

ENABLE procedure command 3-2 
MSRJE procedure command 3-4 
Remote Location Selection display 2-12, 2-30 
remote printer definition, JES2 SNA 8-13 
remote printer separator pages, JES2 SNA 8-8 
remote punch definition, JES2 SNA 8-17 
remote reader definition, JES2 SNA 8-20 
remote system 

selecting BSC 2-12 
selecting SNA 2-30 
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remote terminal function interyal, JES2 BSC 7-10 
remote terminal function interva!, JES2 SNA 8-S 
remote work station definition 
JES2BSC 741 
JES2 SNA 8«9 
JES3 SNA 8-25 

remote work station definition^ JES2 SNA 8-9 
remote, definition G-8 
REMOTEnn parameter, for BS VM370 RSCS 
SIGNON 2-18 
remove a subsystem member 
BSC 2-8 
SNA 2-26 

request unit, definition G-8 
requirements for MSRJE 1 -7 
RES 
BSC 

automatic logoff 7-28 

buffer size 7-29 

buffers, number of 7-29 

console output 7-29 

console suport 7-28 

example C-1 

generation 7-27 

generation example 7-31 

interface type 7-28 

leased line 7-28 

line description, RTAM 7-27 

line identifier, RTAM 7-27 

line macro, RTAM 7-27 

line member configuration example C-1, C-5 

line number 7-28 

line speed 7-28 

message buffers 7-29 

multileaving buffers 7 -30 

number of buffers 7-29 

number of host readers 2-23 

number of printers 2-20, 7-29, 7-30 

number of punches 2-20, 7-29 

number of readers 7-28 

print width 7-28 

printers, number of 7-29, 7-30 

punches, number of 7-29 

readers, number of 7-28 

RTAM generation 7-27 

RTAM macro 7-29 

system generation requirements 7-27 

terminal description 7-28 

terminal identifier 7-28 

TERMINAL macro 7-28 

terminal type 7-28 

timeout value 7-29 

total number of punches 7-30 

total number of readers 7-30 

transmission code 7-29 

transparency 2-23,7-28 


RES (continued) 

BSC LOGON 2-17 

host subsystem work sheets A-6, A-15 

SNA 

application ID, RTAM macro 8-30 
APPLID, RTAM macro 8-30 
buffer size 8-29 
BUFXSIZ parameter 8-29 
CNMSGNO 8-28 
compaction, RTAM macro 8-30 
compression, RTAM macro 8-30 
CONPR parameter 8-29 
console message buffers 8-28 
console printer 8-29 
console support 8-28 
example C-13 
generation example 8-31 
generation requirements 8-27 
interface type 8-28 

line member configuration example C-13 

maximum number of sessions 8-29 

NODE parameter 8-29 

number of buffers 8-29 

number of host readers 2-44 

number of printer 8-28 

number of printers 2-41 

number of printei^, total 8-30 

number of punches 2-41, 8-28 

number of punches, total 8-30 

number of readers 8-28 

number of readers, total 8-29 

password, RTAM macro 8-30 

PCHS parameter 8-28 

permanent logon 8-29 

PLGN parameter 8-29 

PTRS parameter 8-28 

RDRS parameter 8-28 

RTAM 8-27 

RTAM generation 8-28 

RTAM macro 8-29 

SESSLIM parameter 8-29 

stages 8-27 

subsystem member configuration example C-19 

system generation 8-27 

TDESCR parameter, TERMINAL macro 8-28 

TERMID parameter, TERMINAL macro 8-28 

terminal description, TERMINAL macro 8-28 

TERMINAL macro 8-28 

terminal number, TERMINAL macro 8-28 

terminal print width 8-28 

terminal type 8-28 

total number of printers, RTAM macro 8-30 
total number of punches, RTAM macro 8-30 
total number of readers, RTAM macro 8-29 
transparency 8-28 
VSl requirements 8-27 
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RES LOGON 
MAIL 2-18 
NOTICES 2-17 
PROC(procname) 2-17 
SNA 

catalogued procedure name 2-37 
general messages 2-37 
general notices 2-37 
MAIL parameter 2-37 
NOTICES parameter 2-37 
password parameter 2-37 
PROC(procname) 2-37 
TERM(termid) 2-37 
userid 2-37 
TERM(termid) 2-17 
reserving blocks 

print output to compressed file with carriage 
information 5-53 

punch output to compressed file for disk file 5-65 
resource security 
definition G-8 

print output to a data file 5-24, 5-29 
print output to compressed file 5-33, 5-42 
print output to compressed file with carriage 
information 5-49 
punch output to a data file 5-55 
punch output to compressed file for disk file 5-61 
response unit, definition G-8 
reviewing a subsystem member 
BSC 2-8 
SNA 2-26 

RJE 

See also remote job entry 
overview 1-3 
terms 1-3 
RJE subsystem 2-4 
RJFILE 

convert print and punch data 1-8 
description 6-1 
parameters 6-2 
procedure command 6-2 

RJFILE procedure, printing compressed disk file 5-2 
RJPLINE, JES3 BSC 7-22 
RJPTERM, JES3 BSC 7-24 
RJPWS statement, JES3 SNA 8-25 
RJTABLE 

defining output 1-8 
procedure command 5-1 
RJTABLE procedure command 5-8 
RMT macro 
JES2 BSC 

subparameters, CONSOLE 7-12 
subparameters, console support 7-12 
subparameters, data record length 7-12 
subparameters, DISCINTV 7-12 
subparameters, disconnect interval 7-12 
subparameters, explanation 7-11 
subparameters, FIXED 7-12 


RMT macro (continued) 

JES2 BSC (continued) 

subparameters, HARDWARE 7-12 
subparameters, MULTI 7-12 
subparameters, NO CON 7-12 
subparameters, NOTRANSP 7-13 
subparameters, number of printers 7-12 
subparameters, number of punches 7-12 
subparameters, number of readers 7-13 
subparameters, NUMPR 7-12 
subparameters, NUMPU 7-12 
subparameters, NUMRD 7-13 
subparameters, PASSWORD 7-13 
subparameters, ROUTECDE 7-13 
subparameters, routing code 7-13 
subparameters, security password 7-13 
subparameters, set up messages 7-13 
subparameters, SETUP ACT 7-13 
subparameters, SETUPINF 7-13 
subparameters, TRANSP 7-13 
subparameters, transparency 7-13 
subparameters, VARIABLE 7-12 
RMTnn parameter, JES2 SNA 8-9 
RMTnnn parameter, BSC JES2 SIGNON 2-16 
RMTnnn.PRm parameter, JES2 SNA 8-13 
RMTnnn.RDm parameter, JES2 SNA 8-20 
Rnnn.PUm parameter, JES2 SNA 8-17 
route code, JES2 BSC 7-19 
ROUTECODE, JES2 BSC 7-13 
routing code 
JES2 BSC 

printer 7-16 
punch 7-17 

work station definition 7-13 

routing code, terminal for JES2 SNA 8-11 
RSCS 
BSC 

host system generation 7-36 
number of printers 2-20 
SIGNON 2-18 
generation BSC 7-36 

RTAM 

BSC 

communications access 7-6 
macroinstructions 7-27 
parameters 7-28 
stage 1 7-27 

stage 2 7-30 

generation for RES SNA 8-28 

JES3 7-7 

SNA 

communications access 8-4 
JES3 8-4 

macroinstructions 8-28 
parameters 8-28 
RES 8-27 
stage 1 8-28 

stage 2 8-29 
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RTAM (remote terminal access method) 8*3 
RTAM macro 

RES SNA 8-29 
RTAM macro, RES BSC 7*29 
rules for coding MSRJE utility control statements 4-2 
run, definition G*8 
running the control table utility 5-8 


s 


S parameter, SRJE procedure command 3*5 
save if error 

compressed file print output to a data file 5-45 
print output to a data file 5-25, 5-30 
punch output to a data file 5-56 
saving the file 

print output to compressed file 5-33, 5-43 
print output to compressed file with carriage 
information 5-50 

punch output to compressed file for disk file 5-62 
SDLC 

See synchronous data link control 
security 

definition G-8 
MSRJE 1-10 
security and MSRJE 1*10 
selecting remote system 
BSC 2-12 
SNA 2-30 

selecting the subsystem member 
BSC 2-11 
SNA 2-29 

selection priority for a JES2 BSC reader 7*19 
sending first LOGON 2*34 
separator cards 

JES2 BSC 7-17 
JES2 SNA punch 8-19 
separator page 

line count, JES2 BSC 7-10 
separator pages 

JES2 SNA printer 8-16 
SNA VSE POWER 8-40 
sequence number 
BSC 

printer file 2-20 
punch file 2-21 

SNA 

printer file 2-41 
punch file 2-41 
sequential file, definition G-8 
session 

definition 1-3, G-9 


session limit, SNA VSE POWER 8-41 
sessions 

maximum number of SNA 2-33 
minimum number of SNA 2-33 
SESSLIM parameter, RES SNA 8-29 
SETFORM utility control statement 
explanation 4-11 
format 4-11 
parameters 

forms name 4-11 
PRn 4-11 
PUn 4-11 

setup header, JES2 SNA 8* 12 
setup information 
JBS2BSC 7-13 
JES2 SNA 8-12 
SETUPACT, JES2 BSC 7-13 
SETUPHDR parameter, JES2 SNA 8-12 
SETUPINF parameter, JES2 SNA 8-12 
SETUPINF, JES2 BSC 7*13 
severity code, definition G*9 

SHOW parameter, ENABLE procedure command 3*2 

sign off, definition G-9 

sign on, definition G*9 

signing a display station off MSRJE 3*23 

SIGNON 

JES2BSC 2-16 
JES3BSC 2-17 
VM370RSCSBSC 2-18 
signon attributes 2-16 
SIGNON LOGON text for BSC 2*16 
single line communications adapter/attachment (SLCA), 
definition G*9 
SLCA 

See single line communications adapter/attachment’ 

SML 7*7 

SMI, VM37a RSCS BSC 7-36 
SNA 

See also systems network architecture 
changing a subsystem member 2-26 
changing remote location 2-30 
CMD default 2-45 
communications access methods 
JES2 8-4 
JES3 8-4 
RTAM 8-4 

communications controller 8-3 

conversion from BSC 8-39 

creating a new subsystem member 2-26 

creating a subsystem member from existing 2-26 

defining a subsystem member 2-27 

defining remote location 2-30 

DEL default 2-45 

deleting a subsystem member 2-26 

editing a subsystem member 2- 26 

editing remote location 2-30 
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SNA (continued) 

ending subsystem member definition 2-45 

existing library name 2-27 

existing member name 2-27 

formatted LOGON 2-34 

forms control table name 2-40 

forms set 2-40 

host data sets 2-42 

host subsystem work sheets A-10 

host system name 2-32 

host system, defining MSRJE to 8-1 

host systems relationships to MSRJE 8-2 

host systems supported by MSRJE 1 -6 

informational messages 2-33 

JES2 

communications access 8-4 
generation 8-5 

host subsystem work sheets A-11 
initialization parameters 8-5 
number of host readers 2-44 
number of printers 2-41 
number of punches 2-41 
JES2 LOGON 

passwordl 2-36 
password2 2-36 
RMTnnn 2-36 
JES3 

communications access 8-4 
generation 8-22 
host subsystem work sheets A-13 
initialization parameters 8-22 
number of host readers 2-44 
number of printers 2-41 
number of punches 2-41 
JES3 LOGON 

password 2-37 
wsname 2-37 

library for subsystem member 2-26 

location name 2-30 

LOGON 

application ID 2-39 
APPLID parameter 2-36 
attributes 2-34 
data 2-39 

DAT A parameter 2-36 
format 2-36 
formatted 2-34 
LOGMODE parameter 2-36 
mode name 2-39 
LOGON attributes 2-39 
MSRJE, remote system definition 2-3 
naming the remote location 2-31 
NCP VTAM host subsystem work sheets A-10 
number 

of MSRJE readers 2-43 
number of host readers 2-44 
number of printers 2-40 


SNA (continued) 

number of punches 
maximum 2-41 
number of sessions 2-33 
printer file sequence number 2-41 
priority level 2-33 
punch attributes 2-40 
punch file sequence number 2-42 
reader attributes 2-43 
remote location 
activating 2-31 
definition 2-31 
name 2-31 
remote system 

selecting 2-30 
remote system name 2-30 
removing remote location 2-30 
RES 

example C-13 

generation 8-27 

generation example 8-31 

host subsystem work sheets A-15 

line member configuration example C-13 

number of host readers 2-44 

number of printers 2-41 

number of punches 2-41 

RTAM 8-27 

subsystem member configuration example C-19 
RES LOGON 
MAIL 2-37 
NOTICES 2-37 
PROC(procname) 2-37 
TERM(termid) 2-37 
userid 2-37 

reviewing a subsystem member 2-26 
reviewing remote location 2-30 
RTAM 

communications access 8-4 
macroinstructions 8-28 
parameters 8-28 
stage 1 8-28 

stage 2 8-29 

selecting remote system 2-30 

selecting the subsystem member 2-29 

specifying member type 2-28 

specifying protocol 2-28 

stage 1 of RTAM generation 8-28 

stage 2 of RTAM generation 8-29 

subsystem member attributes 2-32 

subsystem member definition 2-25 

subsystem member name 2-26 

subsystem member selection 2-29 

subsystem member, associated line member 2-29 

sybsystem type 2-29 

termination delay 2-32 

transparency 2-44 

TYPE default 2-44 
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SNA (continued) 

VSE POWER 

generation 8-40 
host subsystem work sheets A-17 
number of host readers 2-44 
number of printers 2-41 
number of punches 2-41 
user information 2-38 
VSE POWER LOGON, remid 2-38 
3705-11 generation example 8-34 
SNA Configuration Member Type display 2-28 
SNA printer attributes 2-40 
SNA Remote Job Entry (SRJE) on System/34 1-10 
SNA Subsystem Member Selection display 2-29 
SNA Upline Facility 
definition G-9 

sharing a line with MSRIE 1-6 
SNUF 1-6 

SNA 3270 device emulation^ sharing a line with 
MSRJE 1-6 
SNBU 

See switched network backup 
SNUF 

See SNA Upline Facility 
solving probleitis F-1 
source member, defiriifioii G-9 
SOURCE parameter, MSRJE procedure command 3-5 
source program, definition G-9 
special character, definition G-9 
specify meiTiber type 
BSC 2-10 
SNA 2 -28 
specify protocol 
BSC 2-10 
SNA 2-28 

specifying BSC subsystem type 2-11 
sperlfylag the BSC LOGON or SIGNON 2-16 
specifying the host system name 
BSC 2-14 
SNA 2-32 
spool file 

activity on 5-40 
definition G-9 
holding output in 5-39 
job name 3-19 
spool message record count 
JES2BSC 7-10 
JES2 SNA 8-8 
spool multileaving line driver 
for VM/370 RSCS 7-7 
SMI 7-36 

spooled data, defining entries for control table 5-3 
spooled output 

hold after printing 5-21 
number of copies 5-21 
print after job step ends 5-21 


spooled output (continued) 
print entry 5-20 
spool file activity 5-22 
spool file priority 5-22 
spooled printer output 5-17,5-35 
spooling, definition G-9 
SSP 

See System Support Program Product 

SSP definition 2-1 
SSP-ICF 

See Interactive Communications Feature 
SSP-ICF Configuration Member Definition display 2-7, 
2-9, 2-25, 2-27 

SSP-ICF Configuration Member Type display 2-10, 2-28 

stage 1 of BSC RTAM generation 7-27 

stage 1 of SNA RTAM generation 8-28 

stage 2 of BSC RTAM generation 7-30 

stage 2 of SNA RTAM generation 8-29 

starting 

a JES2 BSC printer 7-15 
a JES2 BSC punch 7-17 
a JES2 BSC reader 7-18 
a JES2 SNA printer 8-15 
a JES2 SNA punch 8-18 
a JES2 SNA reader 8-20 
a JE$3 BSC line 7-23 
an MSRJE session 3-3 
the CNFIGICF procedure 2-2 
the control table utility 5-8 
statement identifiers, MSRJE utility control 
statements 4-2 
station, definition G-9 
status 

definition G-9 
of MSRJE 3-27 
subconsole display, definition G-9 
subconsole, definition G-9 
subroutine member, definition G-9 
subsystem definition 
BSC example 2-7 
example BSC 2-7 
SNA 2-25 
subsystem member 
BSC 

associating with a line member 2-11 
changing 2-8 
creating 2-8 
creating from existing 2-8 
defining attributes 2-14 
deleting 2-8 
reviewing 2-8 
selecting type of 2-11 
selection 2-11 
viewing 2-8 
changing 

BSC 2~8 
SNA 2-26 
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fncmbcr (conlinued) 
defining 2-27 
dcrniUioi-i 2"4 
explenalion 2-4 
sderiing SNA 2-29 
SN/\ 

aitnhiiles 2-32 
ticfiniiion 2-25 
viewing BSC 2-8 

ssikssysivoria wieiisber derinUioii, ending SNA 2-45 

''tel'Dsysies'a memtier name 

nsc 2-8 

BiN ABI Ji procedure 3- i 
SN/v 2-26 

sa?;i»v>,sU'‘nii operaikm for SNA 2-26 
MibsyskMrt type, SNA 2-29 
viiibv/siem, definition G-9 
.■»y:p|i«ricd host systems 
BSC 7-1 * 

SNA 8-1 

swivelled line, deOnilio-n C-9 

swdehed pxnlwork hackop (SNBU), definition G-9 

syiieihronons data link control (SDLC), definition G-9 

synciironoMs, definition G-9 
8'I^S^OIJI' slaicrneot, JES3 SNA 8-27 
sysiem ronifigiiratioo 2-1 
system configuration, definition G-9 
system console, definition G-9 
system generation 
JliS2SNA 8-5 
1CS3 SNA 8-22 
VSH POWER SNA 8-40 
.system library, definition G-9 
system piisder, definition G-9 
sysIciB resource security and MSRJE 1-10 
sysfeiiii services control point (SSCP), definition G-9 
system unit, definiiion G-10 

wide parameters, JES2 SNA 8-5 
SyMem/34 MRJE 1-10 
System./36 MSRJE 1-4 
system, definition G-9 

systems network architecture (SNA), definition G-10 


0 

labSe name, control table utility defining 5-8 
table, definition G-10 

'JBESet parameter, SNA RES TERMINAL macro 8-28 
teleprocessing buffer size 
JES2 BSC 7-10 
JES2 SNA 8-8 

T£lM(ierriiid), BSC RES LOGON 2-17 


TERMID parameter, SNA RES TERMINAL macro 8-^28 

terminal characteristics, PRMT macro SNA VSE 

POWER 8-41 

terminal definitions, JES3 BSC 7-24 
terminal description 

RES BSC 7-28 

SNA RES TERMINAL macro 8-28 
terminal identification number, SNA VSIE P€>V/ER 8-41 
terminal identifier, RES BSC 7-28 
TERMINAL macro 
RES BSC 7-28 
RES SNA 8-28 
terminal name, JESS BSC 7-20 
terminal number, SNA RES TERMINAL macro 8-28 
TERMINAL parameter, JES2 SNA 8-9 
terminal password, SNA VSE POWER 8-41 
terminal print width, RES SNA 8-28 
terminal routing code, JES2 SNA 8-11 
terminal type 

JES2 SNA 8-9 
JES3 BSC 7-20 
RES 

BSC 7-28 
SNA 8-28 

RJPTERM JES3 BSC 7-24 
VSE POWER SNA 8-41 
terminal, definition G-10 
terminating an MSRJE reader 3-13 
terminating MSRJE during unattended operation 3-26 
termination 

delay, specifying 4-13 
MSRJE conneclion to the host 3-24 
MSRJE reader 3-17 
termination delay time 
BSC 2-15 
SNA 2-32 

termination delay, specifying 4-0 
terms used by RJE 1 -3 
text transparency 
BSC 2-23 
SNA 2-44 

timeout value, RES BSC 7-29 
total number 

of RES BSC printers 7-30 
of RES BSC punches 7-30 
of RES BSC readers 7-30 

total number of printers, SNA RES RTAM macro 8-30 
total number of punches, SNA RES RTAM macro 8-30 
total number of readers, SNA RES RTAM macro 8-29 
traditional computer input 1-1 
translation table, definition G-10 
transmission code 
JES2BSC 7-11 
RES BSC 7-29 
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transinlssloii control characters, definition G-10 
transparency 
BSC 

JES2 2-23 
1ES3 2-23 
RES 2-23 
VM370 RSCS 2-23 
RES 

BSC 7-28 
REAM BSC 7-28 
RES SNA 8-28 
transparency, line 
JES2BSC 7-11 
JES3 BSC 7-22 
transparency, terniinal 
IES2BSC 7-13 
JES3 BSC 7-24 
transparent data, definition G-10 
transparent text mode 
BSC 2-23 
SNA 2-44 

transparent text mode, definition G-IO 
truncate, definition G-10 
turnaround time, definition G-10 
turnaround, definition G-10 
TYPE default 
BSC 2-24 
SNA 2-44 

TYPE, SNA JES3 CONSOLE parameter 8-22 



unattended operation 3-26 
unbind command, definition G-10 
unique, definition G-10 
unit type, JES2 SNA 8-9 
unprocessed records 

converting from punch 6-1 
defining entries for control table 5-3, 5-5 
definition G-10 
print output 3-19 
updating a print default entry 5-54 
updating a punch default entry 5-67 
user-defined file 

defining entries for control table 5-4, 5-6 
defining punch entries for control table 5-7 
user ID 

print output to a data file 5-24, 5-29 
print output to compressed file 5-33, 5-42 
print output to compressed file with carriage 
information 5-49 
punch output to a data file 5-55 
punch output to compressed file for disk file 5-61 


userid parameter far BSC RES LOGON 2-17 
utility cantral statements 
CANCEL 4-9 
comments in MSRJE 4-2 
definition G-10 
END 4-13 
EOF 4-g 
INFOMSG 4-12 
LIBRARY 4-6 
MSRJE 

console input 4-1 
controiers 4-1 
format 4-2 
keyword definition 4-2 
reader input 4-1 
rules for coding 4-2 
statement identifiers 4-2 
parameters 

CANCEL 4-9 
END 4-13 
INFOMSG 4-12 
READFILE 4-3 
SETFORM 4-11 
READFILE 4-3 
SETFORM 4-1! 
utility program, deflnltloit G-10 



valid, derinltion G-10 
variable, definition G-10 
vertical tab table, derinition G-10 
view configuration values, ENABLE procedure 
command 3-2 
viewing a subsystem member 
BSC 2-8 
SNA 2-26 
virtual machine 

attributes, VM370 RSCS 
BSC 7-36 
paths, VM370 RSCS 
BSC 7-36 
VM370 RSCS 
BSC 

communications access 7-7 

file class 7-36 

generation 7-36 

host subsystem work sheets A-8 

link identifier 7-36 

number of host readers 2-23 

number of printers 2-20 

number of punches 2-20 

password 7-39 

transparency 2-23 

virtual machine attributes 7-36 


Multiple Session Remote Job Entry Guide 



VM370 RSCS (continued) 

BSC (continued) 

virtuai machine pain 7-36 
work station definition 7-36 
work station number 7-39 
BS(' SIGNON 2-18 
VM370 RSCl, host name 2-14 
Voice-grade telephone line, definition G-10 
volume iahle of contents (VTOC), definition G-10 
VSE POWDER 

application !D 8-40 

console support 8-41 

data block si/e 8-40 

ho;;l suhsyslcrn work sheets A-17 

joh separators 8-40 

logical unit name 8-41 

COGEjN 2-38 

number of host readers 2-44 

number of LU sessions 8-40 

number of printers 2-41 

numbef of punches 2-41 

password 8-40 

POWER macro 8-40 

separator pages 8-40 

session limit 8-41 

system generation 8-40 

terminal characteristics, PRMT macro 8-41 

terminal identification number 8-41 

leriTiitial password 8-41 

lermiiial type 8-41 

VSE POWER LOGON, SNA user information 2-38 

VS I 8-27 
¥\rAM password 
iES2 SNA 8-5 
JES3 SNA 8-22 

VTAM, sencimg hind command B-l 
VTOC 

See voliiriie table of contents 


work station (continued) 

name for RJPTERM 7-24 
name for SNA JES3 8-25 
number for BSC VM370 RSCS 7-39 
remote 1-3 

work station definition for BSC VM370 RSCS 7~36 
Work with control tables display 5-8, 5-9 
World Trade, definition G-10 


X 


X.21 feature, definition G-10 

X.21 short hold mode, definition G-10 

X.21, definition G-10 

X.25 link protocol, MSRJE 8-1 

X.25, definition G-10 

X,75, definition G-10 


Numerics 


3270 Device Emulation, definition G-11 
3278 Device Emulation, definition G-11 
37xx communications controller 7-6, 8-3 
3705 NCP/PEP generation 7-33 



wait interval for SNA JES2 8-12 
WAITIME parameter for SNA JES2 8-12 
work sheeis 

host subsystem 

use A-2 

SNA A-10 
host system 

uses during configuration 2-25 
host system, filling out 2-2 
work .station 

console support for SNA JES3 8-26 

definition G-10 

group name for SNA JES3 8-26 
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